AnpherosAnpheros PlatformDevelopers

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 端点以及 FHIR R4 术语(CodeSystem、ValueSet、ConceptMap、$lookup)提供列表。患者报告的症状存储为 FHIR Observation,其中包含代码、患者自己的描述、强度,以及已知时症状的开始和结束时间。 本页展示了如何查找概念、患者报告的症状的外观、如何检查您自己编写的症状,以及数据故意不包含的内容。

版本内容

版本 2026.10.4 (所有响应都会说明)
概念 274:197 种症状 (ICD-10 R00–R69 及其非残留子类别,如 R06.0 呼吸困难或 R43.0 嗅觉缺失,以及 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 版 (2026 年 10 月 15 日) 及其包含和排除说明进行检查;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 辅助审查,非专业医学翻译员;对于 2026.10.3 版本新增的 188 个概念,罗马尼亚语名称也是 AI 翻译)
临床审查 clinical_review: false — 没有临床医生审查过此版本;没有病因或疾病关联
警告标志 32 个,涉及 14 个概念,直接引用自 CDC 和 NIDDK 页面 (review: source_quoted)

标识符永不重复使用。已撤回的概念将保留在列表中,并带有 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 匹配概念 ID、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"

患者报告的症状

这是 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}"}
}

永不发布为症状的内容

只有存在且关于患者本人的症状才会成为 Observation,并且仅在自由文本被标准化之后。诸如“我头不再疼了”、“明天可能发烧”、“我母亲咳嗽了”或正常化器无法读取的文本,都不会成为患者的症状;如果已发布的症状后来被更正为以上任何一种,其 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:

规则 严重性
Category urn:anpheros:observation-category\|symptom (HL7 observation-category 系统没有 symptom 代码) error
code.text present error
An Anpheros concept that exists and matches the ICD-10 code error
subject is a Patient; status final, amended, corrected or entered-in-error; effective[x] present; effectivePeriod.end not before start error
Intensity as UCUM {score} between 0 and 10 error
Only free text, no codes information (still valid)

与其他配置文件一样,它会报告而不是拒绝写入。您发送的 meta.profile 会保留在存储的资源中。

限制

相关

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

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy