# 症状データAPI：概念、FHIR用語、患者報告の症状 > ICD-10にマッピングされた安定した症状識別子を、RESTおよびFHIRのCodeSystem、ValueSet、ConceptMapとして提供します。患者報告の症状のObservationの形式と、その検証方法について説明します。 Source: https://developers.anpheros.com/ja/guides/symptom-data-api **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) ```bash 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`。 ```json { "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用語と同じリスト ```bash 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`、または ICD-10 コードが概念よりも広範な場合（H53.8「その他の視覚障害」はかすみ目よりも広範）は `wider`。 - すべて読み取り専用であり、サーバーの `CapabilityStatement`（`GET $BASE/metadata`）にリストされています。 ## 患者が報告した症状 Anpheros Daily では、個人が自身について報告した症状の存在を以下のように記述します。 ```json { "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` のような同意スコープも同様に機能します。 ### 症状として公開されないもの 「もう頭痛がしない」「明日熱が出るかもしれない」「母が咳をしている」といった記述や、正規化ツールが読み取れなかったテキストは、患者の症状として Observation にはなりません。公開された症状が後にこれらのいずれかに修正された場合、その Observation は取り消されます（ソフト削除 - 履歴は残ります）。親族の訴えは自動的に家族歴にはなりません。 ## 入力した症状を確認する ```bash 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` は、保存されたリソースに保持されます。 ## 制限事項 - このリリースは臨床医によるレビューを受けていません。コーディングおよび検索に使用してください。医療上の意思決定には使用しないでください。 - 警告サインは、公開ドメインの米国連邦政府のページ（CDC: 脳卒中と心臓発作の兆候、NIDDK: 下痢と便秘）から逐語的に引用されており、2026年10月15日にこれらのページと照合されました。各項目には、ソースの見出し（`context`）、アドバイス（`quote`）、適用対象グループ（`applies_to`）、ライセンスと帰属表示付きのソース（`review: source_verified`）、および診断ではなく臨床医によるレビューを受けていないという注記が含まれています。ソースはアメリカのものです。引用で9-1-1と記載されている場合、ヨーロッパの緊急番号は112であるという注記が追加されます。 - 原因や疾患の関連情報は提供されません。項目が臨床医によってレビューされるまで、`associations` は空のままです。関連付けは常に「関連している可能性がある」となります。 - SNOMED CT コードは、ライセンスが許可する場合にのみ記載されます（[FHIR コードシステム](https://developers.anpheros.com/ja/guides/fhir-code-systems)を参照）。 - 以前の症状の観測は、次回更新時に Anpheros コンセプトコーディングを受け取ります。 ## 関連情報 - [Anpheros Symptom Engine: 方法論](https://developers.anpheros.com/ja/guides/symptom-engine): コンセプトの割り当て、チェック、評価方法 - [Anpheros Search](https://developers.anpheros.com/ja/guides/anpheros-search): 症状、病状、治療法をソースとともに横断検索 - [FHIR コードシステム](https://developers.anpheros.com/ja/guides/fhir-code-systems): リソースタイプごとのコードシステム - [Longitudinal patient data API](https://developers.anpheros.com/ja/guides/longitudinal-patient-data-api) - [FHIR R4 を使用した医療記録の保存方法](https://developers.anpheros.com/ja/guides/store-medical-records-fhir) - [FHIR プラットフォーム](https://developers.anpheros.com/ja/guides/fhir)