# Healthcare API: τι είναι και πώς λειτουργεί

> Τι είναι ένα healthcare API, πώς λειτουργεί μια κλήση, τι να προσέξετε και ένα δωρεάν FHIR R4 healthcare API με συναίνεση ασθενούς, προέλευση και φιλοξενία στην ΕΕ — με παραδείγματα και Συχνές Ερωτήσεις.

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

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

<!-- visual: hapi-hero -->

## Πώς λειτουργεί μια κλήση API υγειονομικής περίθαλψης

Ανεξάρτητα από τον προμηθευτή, μια κλήση API υγειονομικής περίθαλψης περνάει από τα ίδια σημεία ελέγχου: ποιος καλεί, σε ποιον ασθενή και σε ποια δεδομένα μπορεί να έχει πρόσβαση, πού είναι αποθηκευμένα τα δεδομένα, ποιος τα έγραψε και ποιος πρέπει να γνωρίζει ότι άλλαξαν.

<!-- visual: hapi-request -->

## Είδη APIs υγειονομικής περίθαλψης

| Είδος | Τι ανταλλάσσει | Τυπική χρήση |
|---|---|---|
| FHIR REST APIs | Πόρους FHIR μέσω HTTP (`GET /Observation?patient=…`) | το σύγχρονο πρότυπο για την ανταλλαγή κλινικών δεδομένων |
| SMART on FHIR / OAuth | Εξουσιοδότηση για FHIR APIs | επιτρέποντας σε εφαρμογές τρίτων να έχουν πρόσβαση σε ένα αρχείο με την άδεια του χρήστη |
| HL7 v2 messaging | Μηνύματα διαχωρισμένα με κάθετη γραμμή (`ORU^R01` για αποτελέσματα, `ADT` για εισαγωγές) | συστήματα εργαστηρίων και νοσοκομείων, συχνά μέσω interfaces αντί για HTTP |
| Document exchange | Κλινικά έγγραφα (PDF, CDA, FHIR document bundles) | περιλήψεις, επιστολές εξιτηρίου, παραπομπές |
| Proprietary REST APIs | JSON ειδικό για τον πωλητή | η δική του εφαρμογή για κινητά ή οι ενσωματώσεις ενός μεμονωμένου προϊόντος |

Το Anpheros συνδυάζει τα δύο πρώτα ως πυρήνα του, δέχεται αποτελέσματα εργαστηρίου HL7 v2 ως είσοδο, αποθηκεύει έγγραφα με τα πρωτότυπά τους και παράγει FHIR document bundles (το International Patient Summary). Προσφέρει επίσης ένα απλούστερο REST API πάνω στα ίδια δεδομένα για προγραμματιστές που δεν θέλουν να εργαστούν απευθείας με το FHIR.

## Τι να αναζητήσετε σε ένα API υγειονομικής περίθαλψης

<!-- visual: hapi-checklist:replace -->

- **Ένα τυπικό μοντέλο δεδομένων**, ώστε τα δεδομένα να μπορούν να μετακινούνται μεταξύ συστημάτων χωρίς προσαρμοσμένη αντιστοίχιση.
- **Εξουσιοδότηση που ελέγχει ο ασθενής**, όχι μόνο διαπιστευτήρια που ελέγχει η εφαρμογή.
- **Προέλευση (Provenance)**: ποιος έγραψε κάθε τιμή, για λογαριασμό ποιου, από ποιο σύστημα.
- **Ιστορικό (History)**: εκδόσεις αντί για σιωπηλές αντικαταστάσεις.
- **Ελεγξιμότητα (Auditability)** των αναγνώσεων, όχι μόνο των εγγραφών.
- **Ασφαλείς επαναδοκιμές (Safe retries)** (ιδεοδυναμία - idempotency) και **προβλέψιμα σφάλματα (predictable errors)**, επειδή τα δεδομένα υγείας δεν πρέπει να διπλασιάζονται ή να χάνονται.
- **Απομόνωση (Isolation)** μεταξύ των εφαρμογών που μοιράζονται την ίδια υποδομή.
- **Διαμονή δεδομένων (Data residency)** που ταιριάζει με την τοποθεσία των ασθενών.

Το υπόλοιπο αυτής της σελίδας δείχνει πώς εμφανίζεται καθένα από αυτά στο Anpheros API.

## Η API του Anpheros με μια ματιά

| Επιφάνεια | Βασικό μονοπάτι | Σκοπός |
|---|---|---|
| FHIR R4 | `/fhir/R4` | 26 τύποι πόρων; ανάγνωση, αναζήτηση, δημιουργία, ενημέρωση, διαγραφή, ιστορικό, συναλλαγές, `$everything`, `$summary`, `$validate` |
| REST v1 | `/v1` | ασθενείς, παρατηρήσεις, καταστάσεις, φάρμακα, έγγραφα, χρονοδιάγραμμα, προέλευση, πλαίσιο AI, εισαγωγή εργαστηρίου, ορολογία, webhooks |
| OAuth 2.1 | `/oauth` | σελίδα συναίνεσης, tokens (PKCE), ανάκληση, κλειδιά OpenID Connect |
| Πλευρά ασθενούς | `/me` | τα δικά αρχεία ενός ατόμου, ποιος έχει πρόσβαση, αρχείο καταγραφής πρόσβασης, ανάκληση |
| Ανακάλυψη | `/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json` | περιγραφές της API αναγνώσιμες από μηχανές |

Βασικό URL: `https://platform.anpheros.com`. Το sandbox και η παραγωγή μοιράζονται το ίδιο· το κλειδί καθορίζει το data plane.

### Έλεγχος ταυτότητας

- **Κλειδιά API** (`sk_test_…`, `sk_live_…`) για τους διακομιστές σας· βλέπουν τους ασθενείς που δημιούργησε το έργο σας.
- **Tokens πρόσβασης OAuth** (`at_…`) για μια εφαρμογή που ενεργεί για έναν ασθενή υπό συναίνεση.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

### Ασφαλής εγγραφή

Τα αιτήματα `POST` δέχονται ένα `Idempotency-Key`: ένα επαναληφθέν αίτημα με το ίδιο κλειδί επιστρέφει την αρχική απόκριση και δεν δημιουργεί τίποτα. Κάθε εγγραφή λαμβάνει ένα `Provenance`· ο τύπος του συγγραφέα αποστέλλεται στο σώμα (`author_type`) ή σε κεφαλίδες όπως `X-Anpheros-Author-Type`, `X-Anpheros-Source-System`, `X-Anpheros-Origin-Id` και `X-Anpheros-On-Behalf-Of`.

```bash
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": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'
```

### Σφάλματα και όρια

Οι τελικοί κόμβοι FHIR απαντούν με `OperationOutcome`· οι υπόλοιποι με `{"error": {"type", "message", "field"}}`. Κάθε απόκριση φέρει `Anpheros-Request-Id`. Το προεπιλεγμένο όριο είναι 600 αιτήματα ανά λεπτό ανά κλειδί και ανά IP. [Σφάλματα](https://developers.anpheros.com/el/guides/errors) · [Όρια](https://developers.anpheros.com/el/guides/limits)

### Γεγονότα

Υπογεγραμμένα webhooks για `resource.created`, `resource.updated`, `resource.deleted`, `consent.granted`, `consent.revoked`, `document.finalized` και `ping`. [Webhooks](https://developers.anpheros.com/el/guides/webhooks)

## Επιλογή μεταξύ FHIR και REST v1

Χρησιμοποιήστε το **FHIR** όταν ήδη εργάζεστε με FHIR, χρειάζεστε τύπους πόρων που το `/v1` δεν καλύπτει (για παράδειγμα `Immunization`, `Procedure` ή `CarePlan`), ή ανταλλάσσετε δεδομένα με άλλα συστήματα FHIR. Χρησιμοποιήστε το **REST v1** για κώδικα εφαρμογής που θέλει επίπεδο JSON για τις κοινές περιπτώσεις. Και τα δύο διαβάζουν και γράφουν τους ίδιους πόρους με τα ίδια αναγνωριστικά, οπότε ένα έργο μπορεί να τα συνδυάσει. Το [Medical data API](https://developers.anpheros.com/el/guides/medical-data-api) περιγράφει τις λειτουργίες δεδομένων λεπτομερώς.

## Συχνές ερωτήσεις

### Τι είναι ένα API υγειονομικής περίθαλψης;
Μια προγραμματική διεπαφή μέσω της οποίας το λογισμικό διαβάζει και γράφει δεδομένα υγείας — αρχεία ασθενών, παρατηρήσεις, διαγνώσεις, φάρμακα και έγγραφα — και μέσω της οποίας εξουσιοδοτείται η πρόσβαση σε αυτά τα δεδομένα. Τα σύγχρονα API υγειονομικής περίθαλψης χρησιμοποιούν HL7 FHIR R4 για τα δεδομένα και OAuth 2.0 ή 2.1 με SMART on FHIR για την εξουσιοδότηση.

### Ποια είναι η διαφορά μεταξύ ενός API υγειονομικής περίθαλψης και ενός FHIR API;
Το FHIR είναι ένα πρότυπο που μπορεί να ακολουθήσει ένα API υγειονομικής περίθαλψης. Ένα FHIR API ανταλλάσσει πόρους FHIR μέσω REST· ένα API υγειονομικής περίθαλψης μπορεί επίσης να δέχεται μηνύματα HL7 v2, έγγραφα ή ιδιόκτητο JSON. Το Anpheros προσφέρει ένα API FHIR R4 και ένα απλούστερο REST API πάνω στα ίδια δεδομένα.

### Υπάρχει δωρεάν API υγειονομικής περίθαλψης για προγραμματιστές;
Ναι. Το sandbox του Anpheros είναι δωρεάν και αυτοεξυπηρετούμενο: συνδεθείτε με το Google, αποκτήστε ένα κλειδί API και εργαστείτε με 30 συνθετικούς ασθενείς μέσω FHIR R4 ή REST. Η παραγωγή ξεκινά από 99 € το μήνα, με τον πρώτο μήνα δωρεάν.

### Πώς δίνουν οι ασθενείς τη συγκατάθεσή τους σε ένα API υγειονομικής περίθαλψης;
Μέσω OAuth 2.1 με PKCE: η εφαρμογή στέλνει το άτομο σε μια σελίδα συγκατάθεσης με SMART on FHIR scopes· το άτομο επιλέγει τι θα μοιραστεί και για πόσο χρονικό διάστημα, μπορεί να δει ένα αρχείο καταγραφής πρόσβασης και μπορεί να ανακαλέσει την πρόσβαση ανά πάσα στιγμή.

### Πού αποθηκεύονται τα δεδομένα;
Στην Ευρωπαϊκή Ένωση: η υπηρεσία και οι βάσεις δεδομένων της εκτελούνται στο Google Cloud `europe-west4` (Ολλανδία).

### Ποιο API υγειονομικής περίθαλψης πρέπει να επιλέξω;
Συγκρίνετε το πρότυπο δεδομένων, ποιος εξουσιοδοτεί την πρόσβαση, την προέλευση και τον έλεγχο, την τοποθεσία των δεδομένων, πώς συμπεριφέρονται οι επαναπροσπάθειες και τα σφάλματα, και αν μπορείτε να δοκιμάσετε με ρεαλιστικά δεδομένα δωρεάν. Το [Πλατφόρμα API υγειονομικής περίθαλψης: τι περιλαμβάνει και πώς να επιλέξετε](https://developers.anpheros.com/el/guides/healthcare-api-platform) μετατρέπει αυτά σε ερωτήσεις που πρέπει να κάνετε σε οποιονδήποτε προμηθευτή.

<!-- visual:cta-hapi -->

## Σχετικά

- [EHR API και API ιατρικών αρχείων](https://developers.anpheros.com/el/guides/ehr-api)
- [Πλατφόρμα Healthcare API: τι περιλαμβάνει και πώς να επιλέξετε](https://developers.anpheros.com/el/guides/healthcare-api-platform)
- [Πώς να δημιουργήσετε ένα Healthcare API με TypeScript](https://developers.anpheros.com/el/guides/healthcare-api-typescript): οδηγός βήμα προς βήμα με Express
- [Πώς να αποθηκεύσετε ιατρικά αρχεία χρησιμοποιώντας FHIR R4](https://developers.anpheros.com/el/guides/store-medical-records-fhir): οδηγός βήμα προς βήμα με curl
- [Healthcare API με συναίνεση ασθενούς](https://developers.anpheros.com/el/guides/healthcare-api-patient-consent)
- [SMART on FHIR backend](https://developers.anpheros.com/el/guides/smart-on-fhir-backend)
- [API ιατρικών δεδομένων](https://developers.anpheros.com/el/guides/medical-data-api)
- [Πλατφόρμα FHIR](https://developers.anpheros.com/el/guides/fhir)
- [Διαλειτουργικότητα δεδομένων υγειονομικής περίθαλψης](https://developers.anpheros.com/el/guides/interoperability)
- [Ενσωματώσεις υγειονομικής περίθαλψης](https://developers.anpheros.com/el/guides/healthcare-integrations)
- [Αναφορά API (OpenAPI)](https://developers.anpheros.com/docs) · [Έλεγχος ταυτότητας και OAuth](https://developers.anpheros.com/el/guides/authentication)