# API δεδομένων συμπτωμάτων: έννοιες, ορολογία FHIR και συμπτώματα που αναφέρονται από ασθενείς

> Σταθεροί αναγνωριστικοί κωδικοί συμπτωμάτων αντιστοιχισμένοι σε ICD-10, που παρέχονται ως REST και ως FHIR CodeSystem, ValueSet και ConceptMap· πώς μοιάζει ένα σύμπτωμα που αναφέρεται από ασθενή και πώς να επικυρώσετε ένα.

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

Η **Anpheros** δίνει σε κάθε σύμπτωμα έναν σταθερό αναγνωριστικό κωδικό (το `SYM-0047` είναι πονοκέφαλος), τον αντιστοιχίζει σε ICD-10 και παρέχει τη λίστα μέσω ενός REST endpoint και ως ορολογία FHIR R4 (`CodeSystem`, `ValueSet`, `ConceptMap`, `$lookup`). Τα συμπτώματα που αναφέρουν οι ασθενείς αποθηκεύονται ως FHIR `Observation`s που φέρουν και τους δύο κωδικούς, τις δικές τους λέξεις του ατόμου, την ένταση και, όταν είναι γνωστό, πότε ξεκίνησε και πότε έληξε το σύμπτωμα. Αυτή η σελίδα δείχνει πώς να βρείτε μια έννοια, πώς μοιάζει ένα σύμπτωμα που αναφέρεται από ασθενή, πώς να ελέγξετε ένα που γράφετε μόνοι σας και τι δεδομένα σκόπιμα δεν περιέχει.

## Τι περιέχεται στην έκδοση

| | |
|---|---|
| Έκδοση | `2026.10.4` (κάθε απόκριση αναφέρει ποια) |
| Έννοιες | 274: 197 συμπτώματα (ICD-10 R00–R69 και οι μη υπολειμματικές υποκατηγορίες τους όπως R06.0 δύσπνοια ή R43.0 ανοσμία, συν τον κωδικό WHO όπου ο WHO ταξινομεί το σύμπτωμα αλλού: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) και 77 ευρήματα (R65, R70–R94) |
| Σύστημα αναγνώρισης | `https://anpheros.com/fhir/CodeSystem/symptom` |
| Κωδικοί | ελέγχθηκαν έναντι της έκδοσης WHO ICD-10 2019 (15 Οκτωβρίου 2026), με τις σημειώσεις συμπερίληψης και αποκλεισμού της· οι τίτλοι WHO ICD-10 δεν παρέχονται μέχρι να επιβεβαιώσει ο WHO την άδεια (`icd10.display: null`), ο επίσημος αγγλικός τίτλος είναι αυτός του ICD-11 |
| ICD-11 | κάθε έννοια αντιστοιχεί σε έναν κωδικό ICD-11 MMS 2025-01 (τον κωδικό συμπτώματος του κεφαλαίου 21) και σε ένα σύστημα σώματος |
| Ετικέτες που παρέχονται | ο αγγλικός τίτλος WHO ICD-11 (`source`), οι ρουμανικές ετικέτες και οι όροι αντιστοίχισης που χρησιμοποιούνται από το Anpheros Daily (`in_use`), και ετικέτες για το ευρύ κοινό σε 19 ακόμη γλώσσες (`ai_reviewed`: μεταφράσεις μηχανής αναθεωρημένες με βοήθεια AI, όχι από επαγγελματία ιατρικό μεταφραστή)· για τις 188 έννοιες που προστέθηκαν στην έκδοση 2026.10.3, το ρουμανικό όνομα είναι επίσης μετάφραση AI |
| Κλινική αναθεώρηση | `clinical_review: false` — κανένας κλινικός δεν έχει αναθεωρήσει την έκδοση· δεν υπάρχουν αιτίες ή συσχετίσεις καταστάσεων |
| Προειδοποιητικά σημάδια | 32, για 14 έννοιες, παρατιθέμενα αυτούσια από σελίδες του CDC και του NIDDK (`review: source_quoted`) |

Οι αναγνωριστικοί κωδικοί δεν επαναχρησιμοποιούνται ποτέ. Μια έννοια που αποσύρεται παραμένει στη λίστα με `status: deprecated`.

## Εύρεση μιας έννοιας (REST)

```bash
export API=https://platform.anpheros.com/v1
export KEY=sk_test_…

curl "$API/terminology/symptoms?q=headache" -H "Authorization: Bearer $KEY"
```

`q` αντιστοιχεί στο αναγνωριστικό της έννοιας, στους κωδικούς ICD-10 και ICD-11, στις ετικέτες και στους όρους αντιστοίχισης. Άλλες παράμετροι: `icd10=R51` (η έννοια για έναν κωδικό), `icd11=MB4D`, `body_system=nervous`, `kind=symptom|finding|all`, `lang=de` (η γλώσσα του `display`: η προτιμώμενη ετικέτα, αλλιώς η απλή ετικέτα, αλλιώς Αγγλικά), `limit` και `offset`.

```json
{
  "data": [{
    "concept_id": "SYM-0047",
    "system": "https://anpheros.com/fhir/CodeSystem/symptom",
    "kind": "symptom",
    "status": "active",
    "display": "Headache, not elsewhere classified",
    "display_lang": "en",
    "icd10": {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51", "display": null, "equivalence": "equivalent"},
    "icd11": {"system": "http://id.who.int/icd/release/11/mms", "code": "MB4D", "display": "Headache, not elsewhere classified", "equivalence": "equivalent"},
    "body_system": {"code": "nervous", "display": "Symptoms, signs or clinical findings of the nervous system", "icd11_block": "BlockL1-MB4"},
    "labels": [
      {"lang": "ro", "use": "preferred", "text": "Durere de cap (cefalee)", "review": "in_use"},
      {"lang": "de", "use": "lay", "text": "Kopfschmerzen", "review": "ai_reviewed"}
    ],
    "match_terms": [{"lang": "ro", "text": "durere de cap"}, {"lang": "ro", "text": "cefalee"}],
    "clinical_review": false,
    "release": "2026.10.2"
  }],
  "total": 1,
  "release": "2026.10.2"
}
```

`labels` παραθέτει κάθε εξυπηρετούμενη ετικέτα (20 γλώσσες· συντομευμένη εδώ). Μια έννοια: `GET $API/terminology/symptoms/SYM-0047`.

## Η ίδια λίστα με την ορολογία FHIR

```bash
export BASE=https://platform.anpheros.com/fhir/R4

curl "$BASE/CodeSystem/anpheros-symptom" -H "Authorization: Bearer $KEY"
curl "$BASE/CodeSystem/\$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro" -H "Authorization: Bearer $KEY"
curl "$BASE/ValueSet/\$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=cough" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd10" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd11" -H "Authorization: Bearer $KEY"
```

- `CodeSystem/anpheros-symptom` — `content: complete`, `status: draft` (η έκδοση δεν έχει ελεγχθεί από κλινικό ιατρό); ιδιότητες `kind`, `status`, `icd10`; ρουμανικές ετικέτες, αντιστοίχιση όρων και ετικέτες για το ευρύ κοινό ως `designation`.
- `ValueSet/anpheros-symptoms` — τα ενεργά συμπτώματα (εξαιρούνται τα ευρήματα). `$expand` λαμβάνει `filter`, `displayLanguage`, `count` και `offset`.
- `ConceptMap/anpheros-symptom-to-icd10` — `equivalent`, ή `wider` όταν ο κωδικός ICD-10 καλύπτει περισσότερο από την έννοια (H53.8 "Άλλες διαταραχές της όρασης" είναι ευρύτερο από τη θολή όραση).
- Όλα είναι μόνο για ανάγνωση και αναφέρονται στο `CapabilityStatement` του διακομιστή (`GET $BASE/metadata`).

## Ένα σύμπτωμα αναφερόμενο από τον ασθενή

Έτσι γράφει το Anpheros Daily ένα σύμπτωμα που ένα άτομο ανέφερε ως παρόν, για τον εαυτό του:

```json
{
  "resourceType": "Observation",
  "status": "final",
  "meta": {"profile": ["https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation"]},
  "category": [{"coding": [{"system": "urn:anpheros:observation-category", "code": "symptom"}]}],
  "code": {
    "text": "Mă doare capul de 3 zile",
    "coding": [
      {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51"},
      {"system": "https://anpheros.com/fhir/CodeSystem/symptom", "code": "SYM-0047", "display": "Headache"}
    ]
  },
  "subject": {"reference": "Patient/…"},
  "effectivePeriod": {"start": "2026-10-11T08:00:00+03:00", "end": "2026-10-14T18:00:00+03:00"},
  "valueQuantity": {"value": 6, "unit": "1-10", "system": "http://unitsofmeasure.org", "code": "{score}"}
}
```

- `code.text` είναι πάντα τα λόγια του ατόμου, στη γλώσσα του (`Observation.language`); οι κωδικοί βρίσκονται δίπλα του.
- `effectivePeriod` χρησιμοποιείται όταν το άτομο δήλωσε πότε ξεκίνησε ή τελείωσε· αλλιώς `effectiveDateTime` είναι η στιγμή που το σημείωσε. Οι ώρες διατηρούν την απόσταση του τηλεφώνου που τις κατέγραψε.
- `valueQuantity` είναι η ένταση σε κλίμακα 1–10· χωρίς αυτήν δεν υπάρχει τιμή.
- Όταν το άτομο επεξεργάζεται ένα σύμπτωμα, ο ίδιος πόρος λαμβάνει νέα έκδοση — διαβάστε προηγούμενες με `GET $BASE/Observation/{id}/_history`.
- Φιλτράρετε κατά κατηγορία με `?category=symptom`· τα πεδία συναίνεσης όπως το `patient/Observation.rs?category=symptom` λειτουργούν με τον ίδιο τρόπο.

### Τι δεν δημοσιεύεται ποτέ ως σύμπτωμα

Μόνο τα συμπτώματα που είναι **παρόντα** και **αφορούν τον ασθενή** γίνονται Παρατηρήσεις (Observations), και μόνο αφού το ελεύθερο κείμενο έχει κανονικοποιηθεί. "Το κεφάλι μου δεν πονάει πια", "ίσως πυρετός αύριο", "η μητέρα μου έχει βήχα" ή ένα κείμενο που ο κανονικοποιητής δεν μπόρεσε να διαβάσει δεν γίνονται σύμπτωμα ασθενούς· εάν ένα δημοσιευμένο σύμπτωμα διορθωθεί αργότερα σε ένα από αυτά, η Παρατήρησή του αποσύρεται (μαλακή διαγραφή — η ιστορία παραμένει). Τα παράπονα συγγενών δεν μετατρέπονται αυτόματα σε οικογενειακό ιστορικό.

## Έλεγχος ενός συμπτώματος που γράφετε

```bash
curl -X POST "$BASE/Observation/\$validate?profile=anpheros-symptom" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/fhir+json" -d @symptom.json
```

Το προφίλ `anpheros-symptom` (κανονικό `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`) αναφέρει, ως `OperationOutcome`:

| Κανόνας | Σοβαρότητα |
|---|---|
| Κατηγορία `urn:anpheros:observation-category\|symptom` (το σύστημα HL7 `observation-category` δεν έχει κωδικό `symptom`) | error |
| `code.text` παρόν | error |
| Μια έννοια Anpheros που υπάρχει και ταιριάζει με τον κωδικό ICD-10 | error |
| `subject` είναι Patient; `status` final, amended, corrected ή entered-in-error; `effective[x]` παρόν; `effectivePeriod.end` όχι πριν από `start` | error |
| Ένταση ως UCUM `{score}` μεταξύ 0 και 10 | error |
| Μόνο ελεύθερο κείμενο, χωρίς κωδικούς | information (still valid) |

Όπως και τα άλλα προφίλ, αναφέρει και δεν απορρίπτει εγγραφές. Ένα `meta.profile` που στέλνετε διατηρείται στον αποθηκευμένο πόρο.

## Όρια

- Η έκδοση δεν έχει ελεγχθεί από κλινικό ιατρό· χρησιμοποιήστε την για κωδικοποίηση και αναζήτηση, όχι για ιατρικές αποφάσεις.
- Τα προειδοποιητικά σημάδια παρατίθενται αυτούσιo από δημόσιες σελίδες των ΗΠΑ (CDC: σημάδια εγκεφαλικού και καρδιακής προσβολής· NIDDK: διάρροια και δυσκοιλιότητα) και ελέγχθηκαν σε σχέση με αυτές τις σελίδες στις 15 Οκτωβρίου 2026. Κάθε στοιχείο φέρει τη δική του επικεφαλίδα από την πηγή (`context`), τη συμβουλή της (`quote`), την ομάδα στην οποία εφαρμόζεται (`applies_to`), την πηγή με την άδεια χρήσης και την αναφορά, `review: source_verified` και τη σημείωση ότι δεν αποτελεί διάγνωση και δεν έχει ελεγχθεί από κλινικό ιατρό. Οι πηγές είναι Αμερικανικές: όπου μια παράθεση λέει 9-1-1, η σημείωση προσθέτει ότι ο αριθμός έκτακτης ανάγκης στην Ευρώπη είναι 112.
- Δεν παρέχονται αιτίες ή συσχετίσεις καταστάσεων: το `associations` παραμένει κενό μέχρι να ελέγξει ένας κλινικός ιατρός ένα στοιχείο. Μια συσχέτιση είναι πάντα "μπορεί να σχετίζεται με".
- Οι κωδικοί SNOMED CT αναγράφονται μόνο όπου η άδεια χρήσης το επιτρέπει (βλ. [Συστήματα κωδικών FHIR](https://developers.anpheros.com/el/guides/fhir-code-systems)).
- Νωρίτερες Παρατηρήσεις συμπτωμάτων λαμβάνουν την κωδικοποίηση εννοίας Anpheros την επόμενη φορά που θα ενημερωθούν.

## Σχετικά

- [Anpheros Symptom Engine: μεθοδολογία](https://developers.anpheros.com/el/guides/symptom-engine): πώς ανατίθενται, ελέγχονται και αξιολογούνται οι έννοιες
- [Anpheros Search](https://developers.anpheros.com/el/guides/anpheros-search): μία αναζήτηση σε συμπτώματα, καταστάσεις και θεραπείες, με πηγές
- [FHIR code systems](https://developers.anpheros.com/el/guides/fhir-code-systems): κάθε σύστημα κωδικοποίησης ανά τύπο πόρου
- [Longitudinal patient data API](https://developers.anpheros.com/el/guides/longitudinal-patient-data-api)
- [Πώς να αποθηκεύσετε ιατρικά αρχεία χρησιμοποιώντας FHIR R4](https://developers.anpheros.com/el/guides/store-medical-records-fhir)
- [FHIR platform](https://developers.anpheros.com/el/guides/fhir)