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, а также в виде терминологии 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 code systems).
• Более ранние наблюдения за симптомами получают кодирование концепции Anpheros при следующем обновлении.

Связанные материалы

• Anpheros Symptom Engine: методология: как концепции назначаются, проверяются и оцениваются
• Anpheros Search: единый поиск по симптомам, состояниям и методам лечения с указанием источников
• Системы кодирования FHIR: каждая система кодирования для каждого типа ресурса
• API для продольных данных пациента
• Как хранить медицинские записи с использованием FHIR R4
• Платформа FHIR

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