# Ιατρικά δεδομένα API

> Πού αντιστοιχεί κάθε είδος ιατρικών δεδομένων στο Anpheros API, πώς κωδικοποιείται και πώς να τα γράψετε, να τα φιλτράρετε, να τα εντοπίσετε, να τα διορθώσετε και να τα διαγράψετε — με λειτουργικά παραδείγματα.

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

**Ένα API ιατρικών δεδομένων παρέχει στο λογισμικό δομημένη πρόσβαση στο περιεχόμενο των αρχείων ασθενών: δημιουργία ασθενούς, καταγραφή μέτρησης αρτηριακής πίεσης, λίστα ενεργών φαρμάκων, επισύναψη εργαστηριακής αναφοράς, εντοπισμός του ποιος έγραψε τι.** Αυτή η σελίδα περιγράφει τις λειτουργίες δεδομένων του Anpheros API — πού αντιστοιχεί κάθε είδος ιατρικών δεδομένων, πώς κωδικοποιείται και πώς να τα ανακτήσετε — με παραδείγματα που λειτουργούν στο sandbox.

Οι εφαρμογές χρησιμοποιούν αυτές τις λειτουργίες για να αντιμετωπίζουν το Anpheros ως την ιατρική βάση δεδομένων του προϊόντος τους: τα αρχεία ασθενών βρίσκονται στην αποθήκη HL7 FHIR R4 της πλατφόρμας, και η εφαρμογή τα διαβάζει και τα γράφει μέσω του API αντί να διατηρεί τους δικούς της πίνακες ιατρικών δεδομένων.

Για την ευρύτερη εικόνα (αυθεντικοποίηση, συναίνεση, συμβάντα) δείτε το [Healthcare API](https://developers.anpheros.com/el/guides/healthcare-api).

## Πού πηγαίνει κάθε είδος ιατρικών δεδομένων

| Ιατρικά δεδομένα | REST v1 | FHIR resource | Κωδικοποίηση |
|---|---|---|---|
| Το άτομο | `POST /v1/patients` | `Patient` | όνομα, ημερομηνία γέννησης, φύλο, αναγνωριστικά |
| Ζωτικά σημεία, εργαστηριακά αποτελέσματα, συμπτώματα, δραστηριότητα, έρευνες | `/v1/patients/{id}/observations` | `Observation` | LOINC (συμπτώματα: κεφάλαιο R του ICD-10); μονάδες UCUM |
| Διαγνώσεις και προβλήματα | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| Φαρμακευτική αγωγή | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, όνομα προϊόντος διατηρείται ως κείμενο |
| Έγγραφα (PDF, εικόνες) | `/v1/patients/{id}/documents` | `DocumentReference` | είδη εγγράφων LOINC |
| Μια ολόκληρη εργαστηριακή αναφορά | `POST /v1/patients/{id}/labs/import` | `Observation` (laboratory) | LOINC όπου είναι γνωστό, αλλιώς ο δικός κωδικός του εργαστηρίου |
| Δοσολογίες που ελήφθησαν ή παραλείφθηκαν, εμβολιασμοί, αλλεργίες, διαδικασίες, αναφορές, σχέδια φροντίδας, στόχοι, παραπομπές, επισκέψεις, ραντεβού, ομάδες φροντίδας, οικογενειακό ιστορικό, ερωτηματολόγια | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | ανά [συστήματα κωδικοποίησης FHIR](https://developers.anpheros.com/el/guides/fhir-code-systems) |

Τα αντικείμενα REST v1 και οι πόροι FHIR είναι οι ίδιες εγγραφές με τα ίδια αναγνωριστικά. κάθε αντικείμενο v1 φέρει την αναφορά `fhir` του.

## Εγγραφή ιατρικών δεδομένων

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

- **Κατηγορίες παρατήρησης:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Σύνθετες μετρήσεις** όπως η αρτηριακή πίεση χρησιμοποιούν `components` (συστολική `8480-6`, διαστολική `8462-4` εντός του πίνακα `85354-9`).
- **Τύποι συγγραφέων:** `patient`, `practitioner`, `device`, `import`, `ai`. Χωρίς έναν, η πλατφόρμα καταγράφει `import`.
- **Κωδικοί που δεν γνωρίζετε απ' έξω:** `GET /v1/terminology/loinc?q=hba1c` αναζητά το ενσωματωμένο υποσύνολο LOINC και `GET /v1/search?q=metformin` τον κατάλογο συμπτωμάτων, παθήσεων και φαρμάκων. μια παρατήρηση που γράφεται χωρίς όνομα εμφάνισης λαμβάνει αυτόματα το όνομα LOINC.

## Ανάγνωση ιατρικών δεδομένων

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

| Endpoint | Φίλτρα |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

Οι λίστες είναι σελιδοποιημένες με `limit` και `cursor`. Η **timeline** συγχωνεύει παρατηρήσεις (observations), καταστάσεις (conditions), φαρμακευτικές αγωγές (medications), έγγραφα (documents), επισκέψεις (visits), ραντεβού (appointments), εμβολιασμούς (vaccinations) και επεισόδια φροντίδας (episodes of care) σε μία χρονολογική λίστα — την φυσική είσοδο για μια οθόνη ιστορικού ασθενούς.

Για οτιδήποτε δεν καλύπτεται από τα REST φίλτρα, χρησιμοποιήστε την αναζήτηση FHIR: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([FHIR platform](https://developers.anpheros.com/el/guides/fhir)).

## Παρακολούθηση και διόρθωση δεδομένων

- **Ποιος το έγραψε:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — μία καταχώρηση ανά έκδοση, με τύπο συγγραφέα, έργο, οργανισμό και σύστημα πηγής.
- **Κάθε έκδοση:** `GET /fhir/R4/{type}/{id}/_history`· ενημερώστε με `If-Match` για να αποφύγετε την παράγραφο αλλαγής κάποιου άλλου.
- **Ιδιοκτησία:** με συναίνεση μπορείτε να διαβάσετε τι έγραψαν άλλοι οργανισμοί, αλλά να αλλάξετε ή να διαγράψετε μόνο ό,τι έγραψε το δικό σας έργο (αλλιώς `403`).
- **Διαγραφή:** `DELETE /v1/{observations|conditions|medications}/{id}`· η διαγραφή ενός `Patient` διαγράφει ολόκληρη την εγγραφή.

## Έγγραφα

Δημιουργήστε το έγγραφο (λαμβάνετε έναν στόχο μεταφόρτωσης), μεταφορτώστε τα bytes μέσω της πλατφόρμας ή απευθείας στο χώρο αποθήκευσης, και στη συνέχεια οριστικοποιήστε. Μετά την οριστικοποίηση, το πρωτότυπο είναι αμετάβλητο· καταγράφονται το SHA-256 και το μέγεθός του. Έως 25 MiB ανά αρχείο.

## Σχετικά

- [Πώς να κανονικοποιήσετε ιατρικά δεδομένα](https://developers.anpheros.com/el/guides/normalize-medical-data): κωδικοί, μονάδες, ημερομηνίες, διπλότυπα, επικύρωση
- [Προέλευση ιατρικών δεδομένων εξηγημένη](https://developers.anpheros.com/el/guides/medical-data-provenance): ποιος έγραψε τι, και πώς να το καταγράψετε
- [API Υγείας](https://developers.anpheros.com/el/guides/healthcare-api)
- [Ιατρικός φάκελος ασθενούς](https://developers.anpheros.com/el/guides/patient-medical-record)
- [Δημιουργία εφαρμογής υγείας](https://developers.anpheros.com/el/guides/build-a-healthcare-app)
- [Αναφορά API (OpenAPI)](https://developers.anpheros.com/docs) · [Οδηγός γρήγορης εκκίνησης](https://developers.anpheros.com/el/guides/getting-started)