Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Gesundheits-API: Was sie ist und wie sie funktioniert

Was eine Gesundheits-API ist, wie ein Aufruf funktioniert, worauf man achten sollte, und eine kostenlose FHIR R4 Gesundheits-API mit Patientenzustimmung, Herkunft und EU-Hosting – mit Beispielen und FAQ.

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.

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.

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

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.

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.

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 · Limits

Ereignisse

Signierte Webhooks für resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized und ping. 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 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 fasst dies in Fragen zusammen, die Sie jedem Anbieter stellen können.