API für Gesundheitsdaten: Worauf Sie achten sollten und wie Sie in einer Stunde einen Patientenakt lesen und schreiben

"Healthcare API" umfasst sehr unterschiedliche Dinge: den HL7 v2-Feed eines Krankenhauses, einen nationalen E-Rezept-Dienst, den Export eines Wearable-Anbieters, einen FHIR-Server. Wenn Sie eine Gesundheits-App, ein Klinik-Tool oder einen KI-Assistenten entwickeln, benötigen Sie etwas Spezifischeres: ein Backend, das die Patientenakte in einem Standardformat speichert, dem Patienten die Entscheidung über den Zugriff überlässt und Ihnen eine saubere API dafür bietet. Dieser Leitfaden beschreibt, worauf Sie achten sollten, und zeigt anhand von echten Aufrufen, wie die erste Stunde auf der Anpheros Platform aussieht.

Technische Version für Entwickler: Healthcare API · Medical data API auf developers.anpheros.com, mit Anfragen, Antworten und Limits. Diese Seite ist die Version in einfacher Sprache.

Was eine Healthcare-Daten-API leisten muss

Fünf Dinge unterscheiden eine nutzbare Gesundheitsdaten-API von einer Datenbank mit HTTP davor.

• Ein Standardformat. HL7 FHIR R4 ist das Format, das Krankenhäuser, nationale Systeme und der europäische Gesundheitsdatenraum verwenden. Eine in FHIR gespeicherte Akte kann von anderen Systemen ohne benutzerdefinierte Brücke gelesen werden. Ein proprietäres JSON nicht.
• Patienteneinwilligung als eigenständiges Objekt. Wer darf was lesen, wie lange, widerruflich, für den Patienten sichtbar. Nicht nur ein Kontrollkästchen in Ihrer eigenen Datenbank.
• Herkunftsnachweis (Provenance). Jeder Wert gibt an, wer ihn geschrieben hat: der Patient, ein Arzt, ein Gerät, ein Import, eine abgeleitete Berechnung. Ein KI-Assistent, der ein Laborergebnis nicht von einer selbst gemeldeten Vermutung unterscheiden kann, ist gefährlich.
• Eine Sandbox mit realistischen Daten. Sie können nicht mit echten Patienten testen und müssen auch nicht selbst 30 synthetische Patienten mit sechs Monaten Historie erfinden.
• Datenresidenz, die Sie benennen können. Für europäische Nutzer bedeutet dies Server in der EU, unter der DSGVO, mit einer Datenverarbeitungsvereinbarung.

Zwei Wege hinein: REST und FHIR, dieselben Daten

Die Anpheros Platform stellt dieselbe Akte zweimal zur Verfügung. Eine einfache REST-API (/v1) für den Produktcode und eine strikte FHIR R4 (/fhir/R4) für alles, was mit dem Rest des Gesundheitssystems kommunizieren muss. IDs sind in beiden identisch; jedes v1-Objekt trägt seinen fhir-Verweis.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# Patienten, die Ihr Projekt sehen kann
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# Laborergebnisse, die neuesten zuerst
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# Aktuelle Medikationen
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# Alles auf einer Zeitachse
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# Dieselben Daten, striktes FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Hinter diesen Aufrufen stehen 26 FHIR-Ressourcentypen (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance und mehr), kodiert mit LOINC für Messungen, ICD-10 für Zustände und ATC für Medikamente.

Einen Schlüssel zu erhalten dauert eine Minute

Die Sandbox ist Self-Service und kostenlos. Melden Sie sich im Dashboard unter platform.anpheros.com/dashboard an, klicken Sie auf Eine Sandbox-Schlüssel erhalten und Sie erhalten eine Organisation, ein Sandbox-Projekt und einen sk_test_…-Schlüssel. Das Projekt enthält eine eigene Kopie von 30 synthetischen Patienten: Erwachsene, Kinder und ältere Menschen aus der gesamten EU, mit Krankheiten, Medikamenten, Allergien, Laborergebnissen und Vitalwerten über sechs Monate. Ändern oder löschen Sie alles; ein Reset bringt sie zurück.

Produktionsschlüssel (sk_live_…) gehen an verifizierte Organisationen mit einer unterzeichneten Datenverarbeitungsvereinbarung. Sandbox und Produktion sind unterschiedliche Datenbanken: Ein Sandbox-Schlüssel kann physisch keinen echten Patienten erreichen.

Was sonst noch in der Box ist

• OAuth 2.1 mit PKCE und SMART on FHIR Standalone Launch, damit eine App eine Person um Zugriff auf ihre eigene Akte bitten kann.
• Einwilligung mit Scopes, Ablaufdatum und Widerruf sowie ein Zugriffsprotokoll, das der Patient lesen kann.
• Signierte Webhooks (HMAC-SHA256, mit Backoff wiederholt) für resource.created, consent.granted, consent.revoked, document.finalized.
• Eine KI-Kontext-API, die eine mit Herkunftsnachweisen versehene Zusammenfassung eines Patienten innerhalb eines Token-Budgets erstellt.
• Import von Laborberichten aus CSV, HL7 v2 ORU^R01 oder JSON, zu LOINC zugeordnet.
• International Patient Summary ($summary) und SMART Health Links zum Teilen per QR-Code.
• SDKs für Dart und TypeScript, eine OpenAPI-Referenz unter /docs und eine CapabilityStatement unter /fhir/R4/metadata.

Der vollständige Leitfaden mit Antworten finden Sie unter developers.anpheros.com/guides/first-hour.

Häufige Fragen

Gibt es eine kostenlose Healthcare-API, mit der ich heute beginnen kann?

Ja. Die Anpheros Sandbox ist kostenlos und Self-Service: Melden Sie sich an, erhalten Sie einen Schlüssel und Sie haben 30 synthetische Patienten zum Lesen und Schreiben. Die Limits betragen 10.000 Ressourcen-Schreibvorgänge pro Tag, 100 eigene Patienten und 250 MB Dokumente pro Projekt.

REST oder FHIR, was sollte ich verwenden?

Verwenden Sie /v1 für Ihren eigenen Produktcode: Es ist einfacher und gibt einfaches JSON zurück. Verwenden Sie /fhir/R4, wenn ein anderes System die Daten lesen muss, wenn Sie FHIR-Suche, _history, $everything oder $summary benötigen oder wenn eine Zertifizierung dies verlangt. Beide sehen dieselbe Akte.

Wie wird die Patienteneinwilligung gehandhabt?

Eine Person erteilt einer Anwendung über OAuth Zugriff auf ihre Akte und wählt dabei Scopes und eine Dauer (30, 90, 180 oder 365 Tage). Die Erlaubnis kann jederzeit widerrufen werden, und der Patient sieht jeden Lesezugriff in einem Zugriffsprotokoll. Details im Consent-Modell.

Wo werden die Daten gehostet?

In der Europäischen Union (Cloud Run, europe-west4), mit Herkunftsnachweisen und Versionshistorie bei jedem Schreibvorgang. Die Produktionsnutzung erfordert eine unterzeichnete Datenverarbeitungsvereinbarung.

Was kostet die Produktion?

Die Produktion beginnt bei 49 € pro Monat für 2.500 gespeicherte Patienten, mit dem ersten Monat kostenlos; größere Pläne kosten 199 € und 799 € pro Monat. Die Sandbox bleibt kostenlos. Siehe Preise.

Funktioniert es mit KI-Agenten?

Ja. Es gibt eine KI-Kontext-API mit Herkunftsnachweisen und einem Token-Budget sowie einen MCP-Server unter platform.anpheros.com/mcp, mit dem jeder MCP-fähige Assistent eine Verbindung herstellen kann. Siehe EMR-Integration mit KI-medizinischen Assistenten.