# Medizinische Daten API

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

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

**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](https://developers.anpheros.com/de/guides/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](https://developers.anpheros.com/de/guides/fhir-code-systems) |

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

## Medizinische Daten schreiben

```bash
# 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

```bash
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](https://developers.anpheros.com/de/guides/fhir)).

## 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.

## Verwandte Themen

- [Medizinische Daten normalisieren](https://developers.anpheros.com/de/guides/normalize-medical-data): Codes, Einheiten, Daten, Duplikate, Validierung
- [Herkunft medizinischer Daten erklärt](https://developers.anpheros.com/de/guides/medical-data-provenance): Wer hat was geschrieben und wie wird es aufgezeichnet?
- [Healthcare API](https://developers.anpheros.com/de/guides/healthcare-api)
- [Patientenakte](https://developers.anpheros.com/de/guides/patient-medical-record)
- [Eine Gesundheits-App erstellen](https://developers.anpheros.com/de/guides/build-a-healthcare-app)
- [API-Referenz (OpenAPI)](https://developers.anpheros.com/docs) · [Erste Schritte](https://developers.anpheros.com/de/guides/getting-started)