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; як виглядає повідомлене пацієнтом спостереження симптому та як його валідувати.

Anpheros надає кожному симптому стабільний ідентифікатор (SYM-0047 – головний біль), зіставляє його з ICD-10 і надає список через REST endpoint, а також як термінологію FHIR R4 (CodeSystem, ValueSet, ConceptMap, $lookup). Симптоми, про які повідомляють пацієнти, зберігаються як FHIR Observation, які містять як коди, власні слова людини, інтенсивність, а коли відомо – коли симптом почався і закінчився. Ця сторінка показує, як знайти концепцію, як виглядає симптом, повідомлений пацієнтом, як перевірити той, який ви пишете самі, і чого навмисно не містять дані.

Що міститься у випуску

Ідентифікатори ніколи не повторюються. Концепція, яка була вилучена, залишається у списку з 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, і тільки після нормалізації вільного тексту. "Мій головний біль більше не турбує", "можливо, завтра буде температура", "у моєї матері кашель" або текст, який нормалізатор не зміг прочитати, не стають симптомом пацієнта; якщо опублікований симптом пізніше виправляється на один із цих, його Observation відкликається (м'яке видалення — історія залишається). Скарги родичів автоматично не перетворюються на сімейний анамнез.

Перевірка симптому, який ви вводите

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, який ви надсилаєте, зберігається в ресурсі.

Обмеження

• Реліз не був переглянутий клініцистом; використовуйте його для кодування та пошуку, а не для медичних рішень.
• Попереджувальні знаки цитуються дослівно з публічних сторінок федерального уряду США (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