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 が症状を別の場所に分類している場合の 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 Version 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 言語; ここでは短縮) を一覧表示します。1 つのコンセプト: 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 として以下を報告します。

ルール 重大度
カテゴリ urn:anpheros:observation-category\|symptom (HL7 observation-category システムには symptom コードがありません) error
code.text が存在 error
ICD-10 コードと一致する Anpheros の概念が存在する 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 は、保存されたリソースに保持されます。

制限事項

関連情報

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