Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

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

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

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

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

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

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

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.

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

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 ένα σύμπτωμα που ένα άτομο ανέφερε ως παρόν, για τον εαυτό του:

{
  "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), και μόνο αφού το ελεύθερο κείμενο έχει κανονικοποιηθεί. "Το κεφάλι μου δεν πονάει πια", "ίσως πυρετός αύριο", "η μητέρα μου έχει βήχα" ή ένα κείμενο που ο κανονικοποιητής δεν μπόρεσε να διαβάσει δεν γίνονται σύμπτωμα ασθενούς· εάν ένα δημοσιευμένο σύμπτωμα διορθωθεί αργότερα σε ένα από αυτά, η Παρατήρησή του αποσύρεται (μαλακή διαγραφή — η ιστορία παραμένει). Τα παράπονα συγγενών δεν μετατρέπονται αυτόματα σε οικογενειακό ιστορικό.

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

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:

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

Όρια

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

Σχετικά

• Anpheros Symptom Engine: μεθοδολογία: πώς ανατίθενται, ελέγχονται και αξιολογούνται οι έννοιες
• Anpheros Search: μία αναζήτηση σε συμπτώματα, καταστάσεις και θεραπείες, με πηγές
• FHIR code systems: κάθε σύστημα κωδικοποίησης ανά τύπο πόρου
• Longitudinal patient data API
• Πώς να αποθηκεύσετε ιατρικά αρχεία χρησιμοποιώντας FHIR R4
• FHIR platform

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card