# Ενσωματώσεις Υγειονομικής Περίθαλψης

> Πρότυπα ενσωμάτωσης που υποστηρίζονται σήμερα: εργαστηριακές αναφορές σε μία κλήση, κλινικές που γράφουν εκ μέρους ενός οργανισμού, συσκευές, εγκεκριμένες εφαρμογές τρίτων, webhooks και SDKs — και ό,τι δεν είναι διαθέσιμο.

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

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

[Εξερευνήστε τον κατάλογο ενσωματώσεων του Anpheros](https://anpheros.com/integrations) για να δείτε κάθε ενσωμάτωση με την επαληθευμένη κατάστασή της (διαθέσιμη, beta ή οδηγός προγραμματιστή), τα δεδομένα και τους πόρους FHIR που ανταλλάσσει, την κατεύθυνσή της, την πιστοποίηση και την τεκμηρίωσή της.

## Εργαστήρια: πλήρεις αναφορές σε μία κλήση

Ένα εργαστήριο, ή οποιοδήποτε σύστημα που διατηρεί εργαστηριακές αναφορές, στέλνει μια πλήρη αναφορά και η πλατφόρμα μετατρέπει κάθε αποτέλεσμα σε εργαστηριακό `Observation`:

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- Μορφές: **CSV** (κεφαλίδες στα Ρουμανικά ή Αγγλικά, δεκτό το δεκαδικό κόμμα), **HL7 v2 ORU^R01** και **JSON**.
- Οι δείκτες αντιστοιχίζονται σε **LOINC** όταν η αναφορά δίνει κωδικό ή το όνομα ταιριάζει με την ορολογία της πλατφόρμας· άλλοι διατηρούν τον δικό τους κωδικό του εργαστηρίου και αναφέρονται ως `unmapped`.
- Κάθε γραμμή λαμβάνει ένα σταθερό αναγνωριστικό, οπότε **η επανυποβολή της ίδιας αναφοράς παραλείπει ό,τι έχει ήδη εισαχθεί**.
- Έως 500 γραμμές ανά αίτημα· κάθε αποτέλεσμα φέρει προέλευση που ονομάζει το σύστημα πηγής και την αναφορά.

Λεπτομέρειες: [Συνδετήρας Εργαστηρίου](https://developers.anpheros.com/el/guides/lab-connector).

## Κλινικές: εγγραφή εκ μέρους ενός οργανισμού

Οι κλινικές και οι άνθρωποι που εργάζονται εκεί είναι πόροι καταλόγου (`Organization`, `Practitioner`, `PractitionerRole`). Το σύστημα μιας κλινικής μπορεί στη συνέχεια να δηλώσει ποιος βρίσκεται πίσω από κάθε αίτημα:

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — ο επαγγελματίας που εργάζεται μέσω της εφαρμογής σας· εγγράφεται στο αρχείο καταγραφής πρόσβασης και εμφανίζεται στον ασθενή με το όνομα·
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — ο οργανισμός για τον οποίο γίνεται μια εγγραφή·
- `X-Anpheros-Author-Ref: Practitioner/<id>` — ο συγγραφέας που καταγράφεται στο `Provenance`.

Με τη συγκατάθεση του ασθενούς, η κλινική διαβάζει ολόκληρο το αρχείο, συμπεριλαμβανομένων όσων έγραψαν άλλοι οργανισμοί, και τροποποιεί μόνο ό,τι έγραψε η ίδια. Πολλαπλοί πόροι μπορούν να εγγραφούν ατομικά με ένα bundle FHIR `transaction` (`POST /fhir/R4`).

Ένα πρακτικό παράδειγμα, από τον κατάλογο έως μια επίσκεψη που γράφτηκε ως μία συναλλαγή: [Πώς να ενσωματώσετε συστήματα κλινικών με ένα backend FHIR](https://developers.anpheros.com/el/guides/integrate-clinic-systems-fhir).

Η ροή συγκατάθεση → εργαστηριακή εξέταση `Observation` που γράφτηκε από ένα έργο κλινικής → ειδοποίηση στην εφαρμογή του ασθενούς έχει υλοποιηθεί end-to-end με ένα δοκιμαστικό έργο κλινικής.

## Συσκευές και φορητές συσκευές

Οι μετρήσεις από συσκευές είναι `Observation`s με `author_type: "device"` και κωδικό LOINC — καρδιακός ρυθμός, αρτηριακή πίεση, SpO₂, βάρος, γλυκόζη, βήματα, διάρκεια ύπνου και άλλα ([FHIR code systems](https://developers.anpheros.com/el/guides/fhir-code-systems)). Το Anpheros Daily γράφει τις ημερήσιες περιλήψεις που διαβάζει από το Apple Health και το Health Connect ως Observations με τον ίδιο τρόπο. Το Anpheros δεν συνδέεται απευθείας με τα cloud των προμηθευτών συσκευών· η εφαρμογή ή το backend σας διαβάζει τη συσκευή και γράφει το αποτέλεσμα. Πώς να διαβάσετε Apple Health, Health Connect και Samsung Health και να αντιστοιχίσετε κάθε μετρήση σε LOINC: [Wearable data in FHIR](https://developers.anpheros.com/el/guides/wearable-data-fhir).

## Εφαρμογές τρίτων: προσβάσιμη πρόσβαση με συναίνεση

Μια εφαρμογή που επιθυμεί δεδομένα που ένα άτομο διατηρεί ήδη στο Anpheros, εγγράφεται μία φορά και ζητά συναίνεση μέσω OAuth 2.1 με PKCE (SMART on FHIR standalone launch):

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — η φιλοξενούμενη σελίδα συναίνεσης·
2. το άτομο επιλέγει τον φάκελο και τη διάρκεια (30, 90, 180 ή 365 ημέρες)·
3. `POST /oauth/token` ανταλλάσσει τον κωδικό για ένα access token (30 λεπτά) και ένα περιστρεφόμενο refresh token (30 ημέρες)·
4. η εφαρμογή βλέπει μόνο αυτόν τον ασθενή, μόνο εντός των πεδίων της (scopes), κάτω από το δικό της pairwise id.

[Authentication and OAuth](https://developers.anpheros.com/el/guides/authentication)

## Γεγονότα: Αντίδραση σε αλλαγές

Αντί για polling, καταχωρήστε ένα webhook. Οι παραδόσεις υπογράφονται με HMAC-SHA256, επαναλαμβάνονται με backoff για έως και 24 ώρες και μεταφέρουν αναγνωριστικά (ids), ποτέ κλινικό περιεχόμενο. Όταν ένα άλλο project γράφει σε ένα αρχείο στο οποίο έχετε πρόσβαση, το γεγονός το αναφέρει (`data.external: true`, με την πηγή). [Webhooks](https://developers.anpheros.com/el/guides/webhooks)

## SDKs

Τα SDKs TypeScript (`@anpheros/sdk`) και Dart / Flutter (`anpheros_sdk`) υλοποιούν όλα τα παραπάνω — εισαγωγή εργαστηριακών αποτελεσμάτων (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth με PKCE, διαχείριση webhooks και επαλήθευση υπογραφής. [SDKs](https://developers.anpheros.com/el/guides/sdks)

## Τι δεν είναι διαθέσιμο

- Έτοιμοι σύνδεσμοι (connectors) για συγκεκριμένα συστήματα EHR νοσοκομείων ή συστήματα πληροφοριών εργαστηρίων. Οι ενσωματώσεις δημιουργούνται έναντι του API.
- Εκκίνηση SMART EHR (εκκίνηση εντός ενός EHR). Υποστηρίζεται μόνο η αυτόνομη εκκίνηση.
- Άμεσες ενσωματώσεις με προμηθευτές συσκευών.

## Σχετικά

- [Πώς να ενσωματώσετε συστήματα κλινικής με ένα FHIR backend](https://developers.anpheros.com/el/guides/integrate-clinic-systems-fhir): οδηγός βήμα προς βήμα για EMR κλινικών
- [Πώς να κανονικοποιήσετε ιατρικά δεδομένα](https://developers.anpheros.com/el/guides/normalize-medical-data): κωδικοί, μονάδες, ημερομηνίες, διπλότυπα, επικύρωση
- [Πώς να εισαγάγετε αποτελέσματα εργαστηρίου σε ένα FHIR record](https://developers.anpheros.com/el/guides/import-lab-results-fhir): οδηγός βήμα προς βήμα με CSV και HL7 v2
- [Διαλειτουργικότητα δεδομένων υγειονομικής περίθαλψης](https://developers.anpheros.com/el/guides/interoperability)
- [API Υγειονομικής Περίθαλψης](https://developers.anpheros.com/el/guides/healthcare-api)
- [Αρχιτεκτονική](https://developers.anpheros.com/el/guides/architecture)
- [Περιπτώσεις χρήσης](https://developers.anpheros.com/el/guides/use-cases)