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

API für medizinische Daten

Wohin jede Art von medizinischen Daten in der Anpheros API gelangt, wie sie kodiert wird und wie man sie schreibt, filtert, verfolgt, korrigiert und löscht – mit funktionierenden Beispielen.

Eine medizinische Daten API gibt Software strukturierten Zugriff auf den Inhalt von Patientenakten: Erstellen Sie einen Patienten, erfassen Sie einen Blutdruckwert, listen Sie aktive Medikamente auf, hängen Sie einen Laborbericht an, verfolgen Sie nach, wer was geschrieben hat. Diese Seite beschreibt die Datenoperationen der Anpheros API – wohin jede Art von medizinischen Daten gehört, wie sie kodiert wird und wie man sie zurückliest – mit Beispielen, die gegen die Sandbox funktionieren.

Anwendungen nutzen diese Operationen, um Anpheros als medizinische Datenbank ihres Produkts zu behandeln: Patientenakten leben im HL7 FHIR R4 Store der Plattform, und die Anwendung liest und schreibt sie über die API, anstatt eigene Tabellen mit medizinischen Daten zu führen.

Für das Gesamtbild (Authentifizierung, Zustimmung, Ereignisse) siehe Healthcare API.

Wo jede Art von medizinischen Daten gespeichert wird

Medizinische Daten	REST v1	FHIR-Ressource	Kodierung
Die Person	`POST /v1/patients`	`Patient`	Name, Geburtsdatum, Geschlecht, Identifikatoren
Vitalwerte, Laborergebnisse, Symptome, Aktivität, Umfragen	`/v1/patients/{id}/observations`	`Observation`	LOINC (Symptome: ICD-10 Kapitel R); UCUM-Einheiten
Diagnosen und Probleme	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Medikamente	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, Produktname als Text beibehalten
Dokumente (PDF, Bilder)	`/v1/patients/{id}/documents`	`DocumentReference`	LOINC-Dokumentarten
Ein vollständiger Laborbericht	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC, falls bekannt, ansonsten der eigene Code des Labors
Eingenommene oder übersprungene Dosen, Impfungen, Allergien, Prozeduren, Berichte, Behandlungspläne, Ziele, Überweisungen, Besuche, Termine, Pflegeteams, Familiengeschichte, Fragebögen	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	pro FHIR-Codesysteme

REST v1-Objekte und FHIR-Ressourcen sind dieselben Datensätze mit denselben IDs; jedes v1-Objekt trägt seinen fhir-Verweis.

Medizinische Daten schreiben

# a lab result with its reference range, linked to the report it came from
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": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'

Beobachtungskategorien: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
Zusammengesetzte Messungen wie Blutdruck verwenden components (systolisch 8480-6, diastolisch 8462-4 innerhalb des Panels 85354-9).
Autorentypen: patient, practitioner, device, import, ai. Ohne einen davon zeichnet die Plattform import auf.
Codes, die Sie nicht auswendig kennen: GET /v1/terminology/loinc?q=hba1c durchsucht die gebündelte LOINC-Teilmenge und GET /v1/search?q=metformin den Katalog von Symptomen, Zuständen und Medikamenten; eine Beobachtung, die ohne Anzeigenamen geschrieben wird, erhält automatisch den LOINC-Namen.

Medizinische Daten lesen

curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

Endpunkt	Filter
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

Listen werden mit limit und cursor paginiert. Die timeline fasst Beobachtungen, Zustände, Medikationen, Dokumente, Besuche, Termine, Impfungen und Behandlungsepisoden in einer chronologischen Liste zusammen – die natürliche Eingabe für einen Patientenverlauf-Bildschirm.

Für alles, was die REST-Filter nicht abdecken, verwenden Sie die FHIR-Suche: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR-Plattform).

Nachverfolgung und Korrektur von Daten

Wer hat es geschrieben: GET /v1/patients/{id}/provenance/{type}/{resourceId} — ein Eintrag pro Version, mit Autorenart, Projekt, Organisation und Quellsystem.
Jede Version: GET /fhir/R4/{type}/{id}/_history; aktualisieren Sie mit If-Match, um zu vermeiden, dass die Änderungen einer anderen Person überschrieben werden.
Eigentümerschaft: Mit Zustimmung können Sie lesen, was andere Organisationen geschrieben haben, aber nur ändern oder löschen, was Ihr Projekt geschrieben hat (andernfalls 403).
Löschung: DELETE /v1/{observations|conditions|medications}/{id}; das Löschen eines Patient löscht den gesamten Datensatz.

Dokumente

Erstellen Sie das Dokument (Sie erhalten ein Upload-Ziel), laden Sie die Bytes über die Plattform oder direkt in den Speicher hoch und schließen Sie es dann ab. Nach der Finalisierung ist das Original unveränderlich; seine SHA-256-Prüfsumme und Größe werden aufgezeichnet. Bis zu 25 MiB pro Datei.