# Orvosi adatok API

> Hová kerül az orvosi adatok minden típusa az Anpheros API-ban, hogyan kódolják őket, és hogyan lehet őket írni, szűrni, nyomon követni, javítani és törölni – működő példákkal.

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

**Az orvosi adatok API-ja strukturált hozzáférést biztosít a szoftverek számára a páciensrekordok tartalmához: hozzon létre egy pácienst, rögzítsen egy vérnyomásmérést, listázza az aktív gyógyszereket, csatoljon egy laborjelentést, kövesse nyomon, ki mit írt.** Ez az oldal az Anpheros API adatkezelési műveleteit írja le – hogy az orvosi adatok melyik típusa hová kerül, hogyan kódolják őket, és hogyan lehet őket visszaolvasni – működő példákkal a sandbox ellen.

Az alkalmazások ezeket a műveleteket használják arra, hogy az Anpherost termékük orvosi adatbázisaként kezeljék: a páciensrekordok a platform HL7 FHIR R4 tárolójában élnek, és az alkalmazás az API-n keresztül olvassa és írja őket ahelyett, hogy saját orvosi adatokat tartalmazó táblákat tartana fenn.

A szélesebb körű áttekintésért (hitelesítés, hozzájárulás, események) lásd: [Egészségügyi API](https://developers.anpheros.com/hu/guides/healthcare-api).

## Hová kerül az egyes orvosi adatok

| Orvosi adatok | REST v1 | FHIR erőforrás | Kódolás |
|---|---|---|---|
| A személy | `POST /v1/patients` | `Patient` | name, birth date, gender, identifiers |
| Életjelek, laboreredmények, tünetek, aktivitás, felmérések | `/v1/patients/{id}/observations` | `Observation` | LOINC (tünetek: ICD-10 R fejezet); UCUM egységek |
| Diagnózisok és problémák | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| Gyógyszerek | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, product name kept as text |
| Dokumentumok (PDF, képek) | `/v1/patients/{id}/documents` | `DocumentReference` | LOINC document kinds |
| Egy teljes laborjelentés | `POST /v1/patients/{id}/labs/import` | `Observation` (laboratory) | LOINC where known, the lab's own code otherwise |
| Bevett vagy kihagyott dózisok, oltások, allergiák, eljárások, jelentések, gondozási tervek, célok, beutalók, látogatások, időpontok, gondozási csapatok, családi anamnézis, kérdőívek | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | per [FHIR code systems](https://developers.anpheros.com/hu/guides/fhir-code-systems) |

A REST v1 objektumok és a FHIR erőforrások ugyanazok a rekordok, ugyanazokkal az azonosítókkal; minden v1 objektum tartalmazza a `fhir` hivatkozást.

## Orvosi adatok írása

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

- **Megfigyelési kategóriák:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Összetett mérések**, mint például a vérnyomás, `components`-at használnak (szisztolés `8480-6`, diasztolés `8462-4` a panelen `85354-9` belül).
- **Szerzőtípusok:** `patient`, `practitioner`, `device`, `import`, `ai`. Enélkül a platform `import`-et rögzít.
- **Kódok, amelyeket nem tud fejből:** a `GET /v1/terminology/loinc?q=hba1c` keres a csomagolt LOINC részhalmazban, a `GET /v1/search?q=metformin` pedig a tünetek, állapotok és gyógyszerek katalógusában; egy megjelenítési név nélkül írt megfigyelés automatikusan megkapja a LOINC nevet.

## Orvosi adatok olvasása

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

| Végpont | Szűrők |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

A listák lapozása a `limit` és a `cursor` segítségével történik. A **timeline** az észleléseket, állapotokat, gyógyszereket, dokumentumokat, látogatásokat, időpontokat, oltásokat és gondozási epizódokat egy kronologikus listává egyesíti – ez a természetes bemenet egy páciens kórtörténeti képernyőjéhez.

Minden olyan esetben, amit a REST szűrők nem fednek le, használja a FHIR keresést: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([FHIR platform](https://developers.anpheros.com/hu/guides/fhir)).

## Adatok nyomon követése és javítása

- **Ki írta:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — egy bejegyzés verziónként, szerző típusával, projektjével, szervezetével és forrásrendszerével.
- **Minden verzió:** `GET /fhir/R4/{type}/{id}/_history`; frissítse a `If-Match` használatával, hogy elkerülje mások módosításainak felülírását.
- **Tulajdonjog:** beleegyezéssel elolvashatja, mit írtak más szervezetek, de csak azt módosíthatja vagy törölheti, amit a saját projektje írt (ellenkező esetben `403`).
- **Törlés:** `DELETE /v1/{observations|conditions|medications}/{id}`; egy `Patient` törlése az egész rekordot törli.

## Dokumentumok

Hozza létre a dokumentumot (kap egy feltöltési célt), töltse fel a bájtokat a platformon vagy közvetlenül a tárhelyre, majd fejezze be. Befejezés után az eredeti megváltoztathatatlan; rögzítésre kerül a SHA-256 és a mérete. Fájlonként legfeljebb 25 MiB.

## Kapcsolódó

- [Orvosi adatok normalizálása](https://developers.anpheros.com/hu/guides/normalize-medical-data): kódok, egységek, dátumok, duplikátumok, validálás
- [Egészségügyi adatok eredetének magyarázata](https://developers.anpheros.com/hu/guides/medical-data-provenance): ki mit írt, és hogyan rögzítsük
- [Egészségügyi API](https://developers.anpheros.com/hu/guides/healthcare-api)
- [Beteg kórtörténete](https://developers.anpheros.com/hu/guides/patient-medical-record)
- [Egészségügyi alkalmazás fejlesztése](https://developers.anpheros.com/hu/guides/build-a-healthcare-app)
- [API referencia (OpenAPI)](https://developers.anpheros.com/docs) · [Első lépések](https://developers.anpheros.com/hu/guides/getting-started)