# Lekárske dáta API

> Kam každý druh lekárskych dát smeruje v Anpheros API, ako je kódovaný a ako ich zapisovať, filtrovať, sledovať, opravovať a mazať — s funkčnými príkladmi.

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

**Lekárske dáta API poskytuje softvéru štruktúrovaný prístup k obsahu záznamov pacientov: vytvoriť pacienta, zaznamenať meranie krvného tlaku, zoznam aktívnych liekov, priložiť laboratórnu správu, sledovať, kto čo zapísal.** Táto stránka popisuje dátové operácie Anpheros API — kam smeruje každý druh lekárskych dát, ako je kódovaný a ako si ho prečítať späť — s príkladmi, ktoré fungujú proti sandboxu.

Aplikácie používajú tieto operácie na to, aby Anpheros považovali za lekársku databázu svojho produktu: záznamy pacientov žijú v HL7 FHIR R4 úložisku platformy a aplikácia ich číta a zapisuje cez API namiesto toho, aby si udržiavala vlastné tabuľky lekárskych dát.

Pre širší obraz (autentifikácia, súhlas, udalosti) si pozrite [Healthcare API](https://developers.anpheros.com/sk/guides/healthcare-api).

## Kam idú jednotlivé druhy lekárskych údajov

| Lekárske údaje | REST v1 | FHIR resource | Kódovanie |
|---|---|---|---|
| Osoba | `POST /v1/patients` | `Patient` | meno, dátum narodenia, pohlavie, identifikátory |
| Životné funkcie, laboratórne výsledky, symptómy, aktivita, prieskumy | `/v1/patients/{id}/observations` | `Observation` | LOINC (symptómy: kapitola R ICD-10); jednotky UCUM |
| Diagnózy a problémy | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| Lieky | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, názov produktu ponechaný ako text |
| Dokumenty (PDF, obrázky) | `/v1/patients/{id}/documents` | `DocumentReference` | druhy dokumentov LOINC |
| Celá laboratórna správa | `POST /v1/patients/{id}/labs/import` | `Observation` (laboratórna) | LOINC, ak je známe, inak vlastný kód laboratória |
| Užité alebo vynechané dávky, očkovania, alergie, procedúry, správy, plány starostlivosti, ciele, odporúčania, návštevy, stretnutia, tímy starostlivosti, rodinná anamnéza, dotazníky | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | podľa [kódovacích systémov FHIR](https://developers.anpheros.com/sk/guides/fhir-code-systems) |

Objekty REST v1 a zdroje FHIR sú rovnaké záznamy s rovnakými identifikátormi; každý objekt v1 nesie svoj odkaz `fhir`.

## Zapisovanie lekárskych údajov

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

- **Kategórie pozorovania:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Zložené merania**, ako je krvný tlak, používajú `components` (systolický `8480-6`, diastolický `8462-4` v rámci panelu `85354-9`).
- **Typy autorov:** `patient`, `practitioner`, `device`, `import`, `ai`. Bez jedného z nich platforma zaznamená `import`.
- **Kódy, ktoré si nepamätáte naspamäť:** `GET /v1/terminology/loinc?q=hba1c` vyhľadá pribalený podskupinu LOINC a `GET /v1/search?q=metformin` katalóg symptómov, stavov a liekov; pozorovanie napísané bez zobrazovaného názvu automaticky získa názov LOINC.

## Čítanie lekárskych údajov

```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 | Filtre |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

Zoznamy sú stránkované pomocou `limit` a `cursor`. **Timeline** spája pozorovania (observations), stavy (conditions), lieky (medications), dokumenty (documents), návštevy (visits), prehliadky (appointments), očkovania (vaccinations) a epizódy starostlivosti (episodes of care) do jedného chronologického zoznamu — prirodzeného vstupu pre obrazovku anamnézy pacienta.

Pre čokoľvek, čo REST filtre nepokrývajú, použite FHIR search: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([FHIR platform](https://developers.anpheros.com/sk/guides/fhir)).

## Sledovanie a oprava údajov

- **Kto to napísal:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — jeden záznam na verziu, s typom autora, projektom, organizáciou a zdrojovým systémom.
- **Každá verzia:** `GET /fhir/R4/{type}/{id}/_history`; aktualizujte pomocou `If-Match`, aby ste predišli prepísaniu zmeny niekoho iného.
- **Vlastníctvo:** so súhlasom môžete čítať, čo napísali iné organizácie, ale meniť alebo vymazávať iba to, čo napísal váš projekt (inak `403`).
- **Vymazanie:** `DELETE /v1/{observations|conditions|medications}/{id}`; vymazanie `Patient` vymaže celý záznam.

## Dokumenty

Vytvorte dokument (získate cieľ nahrávania), nahrajte bajty cez platformu alebo priamo do úložiska a potom finalizujte. Po finalizácii je originál nemenný; zaznamená sa jeho SHA-256 a veľkosť. Maximálne 25 MiB na súbor.

## Súvisiace

- [Ako normalizovať lekárske údaje](https://developers.anpheros.com/sk/guides/normalize-medical-data): kódy, jednotky, dátumy, duplicity, validácia
- [Vysvetlenie pôvodu lekárskych údajov](https://developers.anpheros.com/sk/guides/medical-data-provenance): kto čo napísal a ako to zaznamenať
- [Healthcare API](https://developers.anpheros.com/sk/guides/healthcare-api)
- [Lekársky záznam pacienta](https://developers.anpheros.com/sk/guides/patient-medical-record)
- [Vytvorenie zdravotníckej aplikácie](https://developers.anpheros.com/sk/guides/build-a-healthcare-app)
- [Referenčná príručka API (OpenAPI)](https://developers.anpheros.com/docs) · [Začíname](https://developers.anpheros.com/sk/guides/getting-started)