# Medicínská datová API

> Kam každý druh medicínských dat v Anpheros API směřuje, jak je kódován a jak je zapisovat, filtrovat, sledovat, opravovat a mazat — s funkčními příklady.

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

**Medicínská datová API poskytuje softwaru strukturovaný přístup k obsahu záznamů pacientů: vytvořit pacienta, zaznamenat naměřený krevní tlak, vypsat aktivní léky, připojit laboratorní zprávu, sledovat, kdo co zapsal.** Tato stránka popisuje datové operace Anpheros API — kam který druh medicínských dat směřuje, jak je kódován a jak si jej přečíst zpět — s příklady, které fungují proti sandboxu.

Aplikace používají tyto operace k tomu, aby Anpheros sloužil jako medicínská databáze jejich produktu: záznamy pacientů žijí v HL7 FHIR R4 úložišti platformy a aplikace je čte a zapisuje prostřednictvím API namísto toho, aby si udržovala vlastní tabulky medicínských dat.

Pro širší kontext (autentizace, souhlas, události) viz [Healthcare API](https://developers.anpheros.com/cs/guides/healthcare-api).

## Kam která data ukládáme

| Lékařská data | REST v1 | FHIR resource | Kódování |
|---|---|---|---|
| Osoba | `POST /v1/patients` | `Patient` | jméno, datum narození, pohlaví, identifikátory |
| Vitální funkce, laboratorní výsledky, symptomy, aktivita, dotazníky | `/v1/patients/{id}/observations` | `Observation` | LOINC (symptomy: kapitola R ICD-10); jednotky UCUM |
| Diagnózy a problémy | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| Léky | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, název produktu ponechán jako text |
| Dokumenty (PDF, obrázky) | `/v1/patients/{id}/documents` | `DocumentReference` | typy dokumentů LOINC |
| Celá laboratorní zpráva | `POST /v1/patients/{id}/labs/import` | `Observation` (laboratory) | LOINC, pokud je znám, jinak vlastní kód laboratoře |
| Podané nebo vynechané dávky, očkování, alergie, procedury, zprávy, plány péče, cíle, doporučení, návštěvy, schůzky, týmy péče, rodinná anamnéza, dotazníky | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | dle [FHIR code systems](https://developers.anpheros.com/cs/guides/fhir-code-systems) |

Objekty REST v1 a FHIR resource jsou stejné záznamy se stejnými ID; každý objekt v1 nese svůj odkaz `fhir`.

## Zápis lékařských dat

```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"
}'
```

- **Kategorie pozorování:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Složené měření**, jako je krevní tlak, používají `components` (systolický `8480-6`, diastolický `8462-4` uvnitř panelu `85354-9`).
- **Typy autorů:** `patient`, `practitioner`, `device`, `import`, `ai`. Bez jednoho platforma zaznamená `import`.
- **Kódy, které si nepamatujete:** `GET /v1/terminology/loinc?q=hba1c` prohledá přiloženou podmnožinu LOINC a `GET /v1/search?q=metformin` katalog symptomů, stavů a léků; pozorování zapsané bez zobrazovaného názvu automaticky získá název LOINC.

## Čtení lékařských dat

```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"
```

| Koncový bod | Filtry |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

Seznamy jsou stránkované pomocí `limit` a `cursor`. **Timeline** slučuje pozorování, stavy, léky, dokumenty, návštěvy, schůzky, očkování a epizody péče do jednoho chronologického seznamu — přirozeného vstupu pro obrazovku historie pacienta.

Pro cokoli, co REST filtry nepokrývají, použijte vyhledávání FHIR: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([platforma FHIR](https://developers.anpheros.com/cs/guides/fhir)).

## Sledování a opravy dat

- **Kdo to napsal:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — jeden záznam na verzi, s typem autora, projektem, organizací a zdrojovým systémem.
- **Každá verze:** `GET /fhir/R4/{type}/{id}/_history`; aktualizujte pomocí `If-Match`, abyste předešli přepsání cizí změny.
- **Vlastnictví:** se souhlasem můžete číst, co napsaly jiné organizace, ale měnit nebo mazat pouze to, co napsal váš projekt (jinak `403`).
- **Mazání:** `DELETE /v1/{observations|conditions|medications}/{id}`; smazáním `Patient` se smaže celý záznam.

## Dokumenty

Vytvořte dokument (získáte cílové místo pro nahrání), nahrajte bajty prostřednictvím platformy nebo přímo do úložiště a poté jej finalizujte. Po finalizaci je originál neměnný; jeho SHA-256 a velikost jsou zaznamenány. Maximálně 25 MiB na soubor.

## Související

- [Jak normalizovat lékařská data](https://developers.anpheros.com/cs/guides/normalize-medical-data): kódy, jednotky, data, duplicity, validace
- [Vysvětlení původu lékařských dat](https://developers.anpheros.com/cs/guides/medical-data-provenance): kdo co napsal a jak to zaznamenat
- [Healthcare API](https://developers.anpheros.com/cs/guides/healthcare-api)
- [Zdravotní záznam pacienta](https://developers.anpheros.com/cs/guides/patient-medical-record)
- [Vytvoření zdravotnické aplikace](https://developers.anpheros.com/cs/guides/build-a-healthcare-app)
- [Referenční příručka API (OpenAPI)](https://developers.anpheros.com/docs) · [Začínáme](https://developers.anpheros.com/cs/guides/getting-started)