# Healthcare API: Was es ist und wie es funktioniert

> Was eine Healthcare API ist, wie ein Aufruf funktioniert, worauf zu achten ist, und eine kostenlose FHIR R4 Healthcare API mit Patienteneinwilligung, Provenienz und EU-Hosting – mit Beispielen und FAQ.

Source: https://developers.anpheros.com/de/guides/healthcare-api

**Eine Healthcare API ist eine programmatische Schnittstelle, über die Software Gesundheitsdaten – Patientenakten, Beobachtungen, Diagnosen, Medikationen, Dokumente – liest und schreibt und über die der Zugriff auf diese Daten autorisiert wird.** Die Anpheros Platform API ist eine Healthcare API über einen patientengesteuerten HL7 FHIR R4 Datensatz: Anwendungen nutzen sie, um medizinische Daten zu speichern und abzurufen, die Einwilligung eines Patienten einzuholen und über Änderungen benachrichtigt zu werden.

<!-- visual: hapi-hero -->

## Wie ein Healthcare-API-Aufruf funktioniert

Unabhängig vom Anbieter durchläuft ein Healthcare-API-Aufruf dieselben Prüfpunkte: Wer ruft an, welcher Patient und welche Daten dürfen berührt werden, wo sind die Daten gespeichert, wer hat sie geschrieben und wer muss wissen, dass sie sich geändert haben.

<!-- visual: hapi-request -->

## Arten von Gesundheits-APIs

| Art | Was wird ausgetauscht | Typische Verwendung |
|---|---|---|
| FHIR REST APIs | FHIR-Ressourcen über HTTP (`GET /Observation?patient=…`) | der moderne Standard für den Austausch klinischer Daten |
| SMART on FHIR / OAuth | Autorisierung für FHIR-APIs | Ermöglicht Drittanbieter-Apps den Zugriff auf einen Datensatz mit Erlaubnis des Benutzers |
| HL7 v2 Messaging | Pipe-getrennte Nachrichten (`ORU^R01` für Ergebnisse, `ADT` für Aufnahmen) | Labor- und Hospitalsysteme, oft über Schnittstellen statt HTTP |
| Dokumentenaustausch | Klinische Dokumente (PDF, CDA, FHIR-Dokumentbündel) | Zusammenfassungen, Entlassbriefe, Überweisungen |
| Proprietäre REST APIs | Herstellerspezifisches JSON | Die eigene mobile App oder Integrationen eines einzelnen Produkts |

Anpheros kombiniert die ersten beiden als seinen Kern, akzeptiert HL7 v2 Laborergebnisse als Eingabe, speichert Dokumente mit ihren Originalen und erstellt FHIR-Dokumentbündel (den International Patient Summary). Es bietet auch eine einfachere REST-API über dieselben Daten für Entwickler, die nicht direkt mit FHIR arbeiten möchten.

## Worauf Sie bei einer Healthcare-API achten sollten

<!-- visual: hapi-checklist:replace -->

- **Ein Standard-Datenmodell**, damit Daten zwischen Systemen ohne benutzerdefinierte Zuordnung übertragen werden können.
- **Eine Autorisierung, die der Patient kontrolliert**, nicht nur Anmeldeinformationen, die die Anwendung kontrolliert.
- **Provenienz**: Wer hat jeden Wert geschrieben, in wessen Auftrag, aus welchem System.
- **Historie**: Versionen statt stiller Überschreibungen.
- **Auditierbarkeit** von Lesevorgängen, nicht nur von Schreibvorgängen.
- **Sichere Wiederholungsversuche** (Idempotenz) und **vorhersehbare Fehler**, da Gesundheitsdaten nicht dupliziert oder verloren gehen dürfen.
- **Isolation** zwischen den Anwendungen, die sich dieselbe Infrastruktur teilen.
- **Datenresidenz**, die mit dem Standort der Patienten übereinstimmt.

Der Rest dieser Seite zeigt, wie sich jeder dieser Punkte in der Anpheros API widerspiegelt.

## Die Anpheros API im Überblick

| Oberfläche | Basis-Pfad | Zweck |
|---|---|---|
| FHIR R4 | `/fhir/R4` | 26 Ressourcentypen; lesen, suchen, erstellen, aktualisieren, löschen, Verlauf, Transaktionen, `$everything`, `$summary`, `$validate` |
| REST v1 | `/v1` | Patienten, Beobachtungen, Zustände, Medikamente, Dokumente, Zeitachse, Herkunft, KI-Kontext, Laborimport, Terminologie, Webhooks |
| OAuth 2.1 | `/oauth` | Zustimmungsseite, Tokens (PKCE), Widerruf, OpenID Connect Keys |
| Patientenseite | `/me` | eigene Datensätze einer Person, wer Zugriff hat, Zugriffsprotokoll, widerrufen |
| Discovery | `/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json` | maschinenlesbare Beschreibungen der API |

Basis-URL: `https://platform.anpheros.com`. Sandbox und Produktion teilen sie; der Schlüssel entscheidet über die Datenebene.

### Authentifizierung

- **API-Schlüssel** (`sk_test_…`, `sk_live_…`) für Ihre Server; sie sehen die Patienten, die Ihr Projekt erstellt hat.
- **OAuth-Zugriffstoken** (`at_…`) für eine Anwendung, die im Namen eines Patienten unter einer Zustimmung handelt.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

### Sicher schreiben

`POST`-Anfragen akzeptieren eine `Idempotency-Key`: eine wiederholte Anfrage mit demselben Schlüssel gibt die ursprüngliche Antwort zurück und erstellt nichts. Jeder Schreibvorgang erhält eine `Provenance`; der Autorentyp wird im Body (`author_type`) oder in Headern wie `X-Anpheros-Author-Type`, `X-Anpheros-Source-System`, `X-Anpheros-Origin-Id` und `X-Anpheros-On-Behalf-Of` gesendet.

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'
```

### Fehler und Limits

FHIR-Endpunkte antworten mit `OperationOutcome`; die anderen mit `{"error": {"type", "message", "field"}}`. Jede Antwort enthält `Anpheros-Request-Id`. Das Standardlimit beträgt 600 Anfragen pro Minute pro Schlüssel und pro IP. [Fehler](https://developers.anpheros.com/de/guides/errors) · [Limits](https://developers.anpheros.com/de/guides/limits)

### Ereignisse

Signierte Webhooks für `resource.created`, `resource.updated`, `resource.deleted`, `consent.granted`, `consent.revoked`, `document.finalized` und `ping`. [Webhooks](https://developers.anpheros.com/de/guides/webhooks)

## Wahl zwischen FHIR und REST v1

Verwenden Sie **FHIR**, wenn Sie bereits mit FHIR arbeiten, Ressourcentypen benötigen, die `/v1` nicht abdeckt (z. B. `Immunization`, `Procedure` oder `CarePlan`), oder Daten mit anderen FHIR-Systemen austauschen. Verwenden Sie **REST v1** für Anwendungscode, der für gängige Fälle flaches JSON wünscht. Beide lesen und schreiben dieselben Ressourcen mit denselben IDs, sodass ein Projekt sie mischen kann. [Medical data API](https://developers.anpheros.com/de/guides/medical-data-api) beschreibt die Datenoperationen im Detail.

## Häufig gestellte Fragen

### Was ist eine Healthcare-API?
Eine programmatische Schnittstelle, über die Software Gesundheitsdaten – Patientenakten, Beobachtungen, Diagnosen, Medikamente und Dokumente – liest und schreibt und über die der Zugriff auf diese Daten autorisiert wird. Moderne Healthcare-APIs verwenden HL7 FHIR R4 für die Daten und OAuth 2.0 oder 2.1 mit SMART on FHIR für die Autorisierung.

### Was ist der Unterschied zwischen einer Healthcare-API und einer FHIR-API?
FHIR ist ein Standard, dem eine Healthcare-API folgen kann. Eine FHIR-API tauscht FHIR-Ressourcen über REST aus; eine Healthcare-API kann auch HL7 v2-Nachrichten, Dokumente oder proprietäre JSON-Daten akzeptieren. Anpheros bietet eine FHIR R4-API und eine einfachere REST-API über dieselben Daten an.

### Gibt es eine kostenlose Healthcare-API für Entwickler?
Ja. Die Anpheros-Sandbox ist kostenlos und self-service: Melden Sie sich mit Google an, erhalten Sie einen API-Schlüssel und arbeiten Sie mit 30 synthetischen Patienten über FHIR R4 oder REST. Die Produktion beginnt bei 99 € pro Monat, wobei der erste Monat kostenlos ist.

### Wie geben Patienten ihre Zustimmung zu einer Healthcare-API?
Über OAuth 2.1 mit PKCE: Die Anwendung leitet die Person zu einer Zustimmungsseite mit SMART on FHIR-Scopes weiter; die Person wählt aus, was und wie lange sie teilen möchte, kann ein Zugriffsprotokoll einsehen und den Zugriff jederzeit widerrufen.

### Wo werden die Daten gespeichert?
In der Europäischen Union: Der Dienst und seine Datenbanken laufen in Google Cloud `europe-west4` (Niederlande).

### Welche Healthcare-API sollte ich wählen?
Vergleichen Sie den Datenstandard, wer den Zugriff autorisiert, Herkunft und Audit, Datenresidenz, wie sich Wiederholungsversuche und Fehler verhalten und ob Sie kostenlos mit realistischen Daten testen können. [Healthcare-API-Plattform: Was sie beinhaltet und wie man wählt](https://developers.anpheros.com/de/guides/healthcare-api-platform) fasst dies in Fragen zusammen, die Sie jedem Anbieter stellen können.

<!-- visual:cta-hapi -->

## Verwandte Themen

- [EHR API und API für medizinische Akten](https://developers.anpheros.com/de/guides/ehr-api)
- [Healthcare API-Plattform: Was sie beinhaltet und wie man sie auswählt](https://developers.anpheros.com/de/guides/healthcare-api-platform)
- [So erstellen Sie eine Healthcare API mit TypeScript](https://developers.anpheros.com/de/guides/healthcare-api-typescript): Schritt-für-Schritt-Anleitung mit Express
- [So speichern Sie medizinische Akten mit FHIR R4](https://developers.anpheros.com/de/guides/store-medical-records-fhir): Schritt-für-Schritt-Anleitung mit curl
- [Healthcare API mit Patienteneinwilligung](https://developers.anpheros.com/de/guides/healthcare-api-patient-consent)
- [SMART on FHIR Backend](https://developers.anpheros.com/de/guides/smart-on-fhir-backend)
- [API für medizinische Daten](https://developers.anpheros.com/de/guides/medical-data-api)
- [FHIR-Plattform](https://developers.anpheros.com/de/guides/fhir)
- [Interoperabilität von Gesundheitsdaten](https://developers.anpheros.com/de/guides/interoperability)
- [Gesundheitsintegrationen](https://developers.anpheros.com/de/guides/healthcare-integrations)
- [API-Referenz (OpenAPI)](https://developers.anpheros.com/docs) · [Authentifizierung und OAuth](https://developers.anpheros.com/de/guides/authentication)