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으로 저장됩니다. 이 페이지에서는 개념을 찾는 방법, 환자가 보고한 증상이 어떻게 보이는지, 직접 작성한 증상의 유효성을 확인하는 방법, 그리고 데이터에 의도적으로 포함되지 않는 내용에 대해 설명합니다.

릴리스 내용

식별자는 절대 재사용되지 않습니다. 철회된 개념은 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"

• 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 코드가 개념보다 더 넓은 경우 wider (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과 같은 동의 범위는 동일하게 작동합니다.

증상으로 게시되지 않는 것

존재하는 환자에 대한 증상만 관찰(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로서 다음과 같이 보고합니다:

다른 프로필과 마찬가지로, 작성은 거부하지 않고 보고합니다. 전송한 meta.profile는 저장된 리소스에 유지됩니다.

제한 사항

• 본 릴리스는 임상의의 검토를 거치지 않았으므로, 의료 결정이 아닌 코딩 및 검색에 사용하십시오.
• 경고 표시는 공개 도메인 미국 연방 페이지(CDC: 뇌졸중 및 심장마비 증상; NIDDK: 설사 및 변비)에서 그대로 인용되었으며 2026년 10월 15일에 해당 페이지와 대조 확인되었습니다. 각 항목에는 출처의 자체 제목(context), 조언(quote), 적용 대상 그룹(applies_to), 라이선스 및 출처 표기가 포함된 출처(review: source_verified)가 있으며, 이는 진단이 아니며 임상의의 검토를 거치지 않았다는 내용이 포함됩니다. 출처는 미국 것이므로, 인용문에서 9-1-1이라고 언급하는 경우 유럽의 긴급 전화번호는 112라는 내용이 추가됩니다.
• 원인 또는 질환 연관성은 제공되지 않습니다: 임상의가 항목을 검토할 때까지 associations은 비어 있습니다. 연관성은 항상 "연관될 수 있음"입니다.
• SNOMED CT 코드는 라이선스가 허용하는 경우에만 작성됩니다( FHIR 코드 시스템 참조).
• 이전 증상 관찰 항목은 다음 업데이트 시 Anpheros 개념 코딩을 받습니다.

관련 자료

• Anpheros 증상 엔진: 방법론: 개념이 할당, 확인 및 평가되는 방식
• Anpheros 검색: 증상, 질환 및 치료에 대한 단일 검색 (소스 포함)
• FHIR 코드 시스템: 리소스 유형별 모든 코드 시스템
• Longitudinal patient data API
• FHIR R4를 사용하여 의료 기록을 저장하는 방법
• FHIR 플랫폼

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