# FHIR-Plattform: verwaltete FHIR R4 mit Patienteneinwilligung

> Eine verwaltete FHIR R4-Plattform: 26 Ressourcentypen, Suche, Verlauf, Transaktionen, $everything, IPS, Inferno-getesteter SMART-Start, Einwilligung und Provenienz, plus eine einfache REST-API. Kostenlose Sandbox.

Source: https://developers.anpheros.com/de/guides/fhir

**Anpheros ist eine FHIR-Plattform – eine verwaltete FHIR-Datenbank (Datenspeicher), die Anwendungen als ihr FHIR-Backend nutzen: Sie speichert jeden Patienten-Datensatz nativ als HL7 FHIR R4 (4.0.1) Ressourcen und stellt diese unter `https://platform.anpheros.com/fhir/R4` bereit,** mit Einwilligung, Provenienz und einem Audit, das auf den Standard aufgesetzt ist. Anwendungen, die bereits FHIR sprechen, können sie direkt nutzen; Anwendungen, die dies nicht tun, können die einfachere REST-API (`/v1`) nutzen, die dieselben Ressourcen mit denselben IDs liest und schreibt.

Für KI-Anwendungen macht dies Anpheros zum FHIR-Backend, aus dem der Kontext eines Modells stammt: siehe [LLM-Anwendungen und Gesundheitsdaten](https://developers.anpheros.com/de/guides/llm-healthcare-data).

<!-- visual:fhir-hero -->

## Was ist HL7 FHIR?

FHIR (Fast Healthcare Interoperability Resources) ist der HL7-Standard für den Austausch von Gesundheitsdaten über das Web. Er definiert:

- **Ressourcen** — kleine, typisierte JSON- (oder XML-) Dokumente für jedes klinische Konzept: eine `Patient`, eine `Observation`, eine `Condition`, eine `MedicationStatement`;
- **Referenzen** dazwischen (`"subject": {"reference": "Patient/123"}`), sodass ein Datensatz ein Graph von Ressourcen um einen Patienten herum ist;
- eine **REST API** zum Lesen, Suchen, Erstellen, Aktualisieren und Löschen von Ressourcen, mit Standard-Suchparametern;
- **Bundles** zum gleichzeitigen Senden mehrerer Ressourcen (Transaktionen) oder als Dokument (z. B. eine Patientenübersicht);
- **Terminologie-Bindings**, sodass Werte Codes aus Systemen wie LOINC oder ICD-10 tragen;
- **Profile** — Einschränkungen für einen Anwendungsfall oder ein Land, wie z. B. die International Patient Summary.

R4 (Version 4.0.1) ist die heute am weitesten verbreitete Release. Die Verwendung von FHIR als Speichermodell – nicht nur als Exportformat – bedeutet, dass es keine Übersetzungsschicht zwischen dem gibt, was eine Anwendung schreibt, und dem, was ein anderes FHIR-System liest.

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "4548-4", "display": "Hemoglobin A1c"}]},
  "subject": {"reference": "Patient/…"},
  "effectiveDateTime": "2026-09-01T08:00:00Z",
  "valueQuantity": {"value": 6.4, "unit": "%", "system": "http://unitsofmeasure.org", "code": "%"}
}
```

## Capability statement

`GET /fhir/R4/metadata` gibt die CapabilityStatement zurück: die unterstützten Ressourcentypen, ihre Suchparameter und die Operationen. Sie ist öffentlich und die maßgebliche Liste; die folgende Tabelle spiegelt sie am 28. September 2026 wider.

## Die 26 Ressourcentypen

<!-- visual:fhir-map:replace -->

| Bereich | Ressourcentypen |
|---|---|
| Patient und Personen | `Patient`, `RelatedPerson` |
| Messungen und Ergebnisse | `Observation` (Vitalparameter, Labor, Symptome, Wohlbefinden, tägliche Aktivität und Schlaf), `DiagnosticReport` |
| Probleme und Versorgung | `Condition`, `EpisodeOfCare`, `Procedure`, `CarePlan`, `Goal`, `ServiceRequest`, `CareTeam`, `FamilyMemberHistory` |
| Medikamente und Prävention | `MedicationStatement`, `MedicationAdministration`, `Immunization`, `AllergyIntolerance` |
| Dokumente und Fragebögen | `DocumentReference`, `QuestionnaireResponse` |
| Besuche | `Encounter`, `Appointment` |
| Verzeichnis | `Organization`, `Practitioner`, `PractitionerRole` |
| Governance | `Consent`, `Provenance` |
| Erweiterungspunkt | `Basic` |

Jeder patientenbezogene Typ gehört zum Patienten-Compartment, daher gelten `Patient/{id}/$everything`, patientenbezogene OAuth-Scopes und Zustimmungsfilter für alle diese Typen. Verzeichnisressourcen (`Organization`, `Practitioner`, `PractitionerRole`) haben keinen Patienten; sie sind in derselben Umgebung projektübergreifend lesbar und nur durch das Projekt änderbar, das sie erstellt hat.

## Interaktionen und Operationen

<!-- visual:fhir-ops -->

- **Read, search, create, update, delete** für jeden unterstützten Typ; Suchparameter pro Typ sind in der CapabilityStatement aufgeführt. Unbekannte Suchparameter werden mit `400` abgelehnt, anstatt stillschweigend ignoriert zu werden.
- **History**: `GET /fhir/R4/{type}/{id}/_history` gibt jede Version zurück; Updates können bedingt mit `If-Match` vorgenommen werden (ein Versionskonflikt antwortet mit `412`).
- **Transaktionen und Batches**: `POST /fhir/R4` mit einem `Bundle` vom Typ `transaction` oder `batch`.
- **`Patient/{id}/$everything`**: das gesamte Compartment eines Patienten.
- **`Patient/{id}/$summary`**: ein International Patient Summary (IPS) Dokument `Bundle`, in englischer oder rumänischer Sprache (`?lang=`).
- **`Observation/$validate?profile=eu-lab`**: berichtet, wie ein Laborergebnis mit den HL7 Europe Laborberichtregeln übereinstimmt.
- **Paging**: `_count` bis zu 200; `_revinclude` gibt höchstens 1 000 Ressourcen zurück.
- **Idempotenz**: `POST` Anfragen akzeptieren einen `Idempotency-Key`; die Wiederholung einer Anfrage mit demselben Schlüssel gibt die gleiche Antwort zurück und erstellt nichts.

```bash
# latest HbA1c results of one patient, strict FHIR
curl "https://platform.anpheros.com/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" \
     -H "Authorization: Bearer $KEY"

# the patient's International Patient Summary
curl "https://platform.anpheros.com/fhir/R4/Patient/$PID/\$summary?lang=en" -H "Authorization: Bearer $KEY"
```

## FHIR und die einfachere REST API

`/v1` existiert für Entwickler, die nicht direkt mit FHIR-Ressourcen arbeiten möchten. Sie deckt Patienten, Beobachtungen, Zustände, Medikamente, Dokumente, eine chronologische Zeitachse und Provenienz ab, sowie Plattformfunktionen (Kontext, Laborexport, Webhooks, Terminologie). Jedes `/v1`-Objekt trägt seinen `fhir`-Verweis, sodass eine Anwendung mit `/v1` beginnen und zu FHIR wechseln kann, wenn sie das vollständige Modell benötigt.

## Standards around FHIR

`$summary` erzeugt eine International Patient Summary, die mit dem offiziellen HL7-Validator validiert wird (0 Fehler); Laborergebnisse werden anhand der HL7 Europe Laborregeln geprüft (derzeit beratend); Drittanbieter-Apps verbinden sich über SMART on FHIR Standalone Launch; HL7 v2 `ORU^R01` Labornachrichten werden als Eingabe akzeptiert. Die Formate, Ebenen und Austauschmuster sind in [Healthcare data interoperability](https://developers.anpheros.com/de/guides/interoperability) beschrieben; die Codesysteme pro Ressourcentyp in [FHIR code systems](https://developers.anpheros.com/de/guides/fhir-code-systems).

## Häufig gestellte Fragen

### Was ist eine FHIR-Plattform?
Ein Dienst, der Gesundheitsdaten als HL7 FHIR-Ressourcen speichert und diese über die standardmäßige FHIR REST API bereitstellt. Er ergänzt den Standard um das, was Anwendungen benötigen: Autorisierung, Zustimmung, Auditierung, Historie und Operationen wie `$everything` und `$summary`. Anpheros ist eine verwaltete FHIR R4-Plattform: Sie rufen sie auf, anstatt einen FHIR-Server zu betreiben.

### Was ist der Unterschied zwischen einem FHIR-Server und einer FHIR-Plattform?
Ein FHIR-Server implementiert die FHIR API über einer Datenbank. Eine FHIR-Plattform betreibt diese für Sie und fügt die Schicht darum herum hinzu – Patientenzustimmung, Herkunftsnachweis, Zugriffsprotokolle, SDKs, Webhooks, Laborimport und eine Sandbox – sodass Anwendungen diese Teile nicht selbst erstellen müssen.

### Welche FHIR-Version unterstützt Anpheros?
FHIR R4 (4.0.1) mit 26 Ressourcentypen, die in der öffentlichen CapabilityStatement unter `/fhir/R4/metadata` aufgeführt sind.

### Wird die Anpheros FHIR-Plattform unabhängig getestet?
Die SMART App Launch STU2 "Standalone Launch"-Gruppe des Open-Source-Testkits Inferno besteht 22 von 22 Tests (Stand 28. September 2026), und der International Patient Summary validiert mit 0 Fehlern im offiziellen HL7-Validator. EHR-Launch und Bulk Data-Export werden noch nicht unterstützt.

### Kann ich die FHIR-Plattform kostenlos nutzen?
Ja. Die Sandbox ist kostenlos und beinhaltet 30 synthetische Patienten pro Projekt; die Produktion beginnt bei 99 € pro Monat mit dem ersten Monat kostenlos.

### Muss ich FHIR verwenden, um Anpheros zu nutzen?
Nein. Eine einfachere REST API (`/v1`) liest und schreibt dieselben Ressourcen mit denselben IDs, sodass eine Anwendung mit flachem JSON beginnen und zu FHIR wechseln kann, wo sie das vollständige Modell benötigt.

<!-- visual:cta-fhir -->

## Verwandte Themen

- [FHIR Sandbox](https://developers.anpheros.com/de/guides/fhir-sandbox): ein kostenloser privater FHIR R4 Testserver
- [International Patient Summary (IPS) in FHIR](https://developers.anpheros.com/de/guides/international-patient-summary-fhir)
- [Erklärung der Herkunft medizinischer Daten](https://developers.anpheros.com/de/guides/medical-data-provenance): wer hat was geschrieben und wie wird es aufgezeichnet
- [Speichern von medizinischen Akten mit FHIR R4](https://developers.anpheros.com/de/guides/store-medical-records-fhir): Schritt-für-Schritt-Anleitung mit curl
- [FHIR vs. eine benutzerdefinierte medizinische Datenbank](https://developers.anpheros.com/de/guides/fhir-vs-custom-database): wann Sie Ihre eigenen Tabellen entwerfen und wann Sie FHIR verwenden sollten
- [Kostenlose FHIR-Datenbank und Sandbox](https://developers.anpheros.com/de/guides/free-fhir-database)
- [Vergleich von Anpheros mit anderen FHIR-Servern](https://developers.anpheros.com/de/guides/fhir-server-comparison)
- [Interoperabilität von Gesundheitsdaten](https://developers.anpheros.com/de/guides/interoperability)
- [FHIR-Codierungssysteme](https://developers.anpheros.com/de/guides/fhir-code-systems)
- [API für medizinische Daten](https://developers.anpheros.com/de/guides/medical-data-api)
- [Erstellen einer Gesundheits-App](https://developers.anpheros.com/de/guides/build-a-healthcare-app)
- [API-Referenz (OpenAPI)](https://developers.anpheros.com/docs)
- [DICOM vs. FHIR](https://developers.anpheros.com/de/guides/dicom-vs-fhir): wo FHIR aufhört und medizinische Bildgebung beginnt