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

Semptom Veri API'si: Kavramlar, FHIR Terminolojisi ve Hastadan Bildirilen Semptomlar

ICD-10'a eşlenmiş sabit semptom tanımlayıcıları, REST ve FHIR CodeSystem, ValueSet ve ConceptMap olarak sunulur; hastadan bildirilen bir semptom Gözlemi nasıl görünür ve birini nasıl doğrularsınız.

Anpheros, her semptoma kararlı bir tanımlayıcı (SYM-0047 baş ağrısıdır) atar, bunu ICD-10'a eşler ve listeyi bir REST uç noktası aracılığıyla ve FHIR R4 terminolojisi (CodeSystem, ValueSet, ConceptMap, $lookup) olarak sunar. Hastaların bildirdiği semptomlar, hem kodları, kişinin kendi kelimelerini, yoğunluğu ve biliniyorsa semptomun ne zaman başladığını ve bittiğini taşıyan FHIR Observation'ler olarak saklanır. Bu sayfa, bir kavramın nasıl bulunacağını, hasta tarafından bildirilen bir semptomun nasıl göründüğünü, kendiniz yazdığınız bir semptomu nasıl kontrol edeceğinizi ve verinin kasıtlı olarak neleri içermediğini gösterir.

Sürümde Neler Var

Tanımlayıcılar asla yeniden kullanılmaz. Geri çekilen bir kavram, status: deprecated ile listede kalır.

Bir kavram bulun (REST)

export API=https://platform.anpheros.com/v1
export KEY=sk_test_…

curl "$API/terminology/symptoms?q=headache" -H "Authorization: Bearer $KEY"

q, kavram kimliği, ICD-10 ve ICD-11 kodları, etiketler ve eşleşme terimleriyle eşleşir. Diğer parametreler: icd10=R51 (bir kod için kavram), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (display'nin dili: tercih edilen etiket, aksi takdirde yaygın etiket, aksi takdirde İngilizce), limit ve 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, sunulan her etiketi (20 dil; burada kısaltılmıştır) listeler. Bir kavram: GET $API/terminology/symptoms/SYM-0047.

FHIR terminolojisi ile aynı liste

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 (sürüm bir klinisyen tarafından incelenmemiştir); kind, status, icd10 özellikleri; Romence etiketleri, designation olarak terim ve halk etiketleriyle eşleşir.
• ValueSet/anpheros-symptoms — aktif semptomlar (bulgular hariç); $expand, filter, displayLanguage, count ve offset alır.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent veya ICD-10 kodu kavramdan daha fazlasını kapsadığında wider (H53.8 "Diğer görsel bozukluklar" bulanık görmeden daha geniştir).
• Hepsi salt okunur ve sunucunun CapabilityStatement (GET $BASE/metadata) listesinde yer alır.

Bir hasta tarafından bildirilen semptom

Anpheros Daily, bir kişinin kendisi hakkında mevcut olduğunu bildirdiği bir semptomu şu şekilde yazar:

{
  "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 her zaman kişinin kendi kelimeleridir, kendi dilinde (Observation.language); kodlar bunun yanında yer alır.
• Kişi ne zaman başladığını veya bittiğini söylediğinde effectivePeriod kullanılır; aksi takdirde effectiveDateTime, kaydettiği andır. Saatler, onları kaydeden telefonun saat dilimini korur.
• valueQuantity, 1-10 ölçeğindeki yoğunluktur; biri olmadan bir değer yoktur.
• Kişi bir semptomu düzenlediğinde, aynı kaynak yeni bir sürüm alır — önceki sürümleri GET $BASE/Observation/{id}/_history ile okuyun.
• Kategoriye göre filtrelemek için ?category=symptom; patient/Observation.rs?category=symptom gibi izin kapsamları aynı şekilde çalışır.

Semptom olarak asla yayınlanmayanlar

Yalnızca mevcut ve hastayla ilgili semptomlar, serbest metin normalleştirildikten sonra Gözlemler (Observations) haline gelir. "Başım artık ağrımıyor", "belki yarın ateş", "annemin öksürüğü var" veya normalleştiricinin okuyamadığı bir metin hastanın semptomu olmaz; yayınlanan bir semptom daha sonra bunlardan birine düzeltilirse, Gözlemi geri çekilir (soft delete — geçmişi kalır). Akrabaların şikayetleri otomatik olarak aile geçmişine dönüştürülmez.

Bir semptomu yazdığınızda kontrol edin

curl -X POST "$BASE/Observation/\$validate?profile=anpheros-symptom" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/fhir+json" -d @symptom.json

anpheros-symptom profili (canonical https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation), bir OperationOutcome olarak şunu bildirir:

Diğer profiller gibi, yazma işlemlerini reddetmez, bildirir. Gönderdiğiniz bir meta.profile, saklanan kaynakta tutulur.

Sınırlamalar

• Sürüm bir klinisyen tarafından incelenmemiştir; tıbbi kararlar için değil, kodlama ve arama için kullanın.
• Uyarı işaretleri, kamu malı ABD federal sayfalarından (CDC: inme ve kalp krizi belirtileri; NIDDK: ishal ve kabızlık) kelimesi kelimesine alıntılanmıştır ve 15 Ekim 2026 tarihinde bu sayfalara karşı kontrol edilmiştir. Her öğe, kaynağın kendi başlığını (context), tavsiyesini (quote), uygulandığı grubu (applies_to), lisans ve atıf ile birlikte kaynağı (review: source_verified) ve teşhis olmadığını ve bir klinisyen tarafından incelenmediğini belirten notu taşır. Kaynaklar Amerikandır: bir alıntı 9-1-1 dediğinde, not Avrupa'daki acil durum numarasının 112 olduğunu ekler.
• Hiçbir neden veya durum ilişkisi sunulmamaktadır: bir klinisyen bir öğeyi inceleyene kadar associations boş kalır. Bir ilişki her zaman "ilişkili olabilir" şeklindedir.
• SNOMED CT kodları yalnızca lisansın izin verdiği yerlerde yazılır (bkz. FHIR kod sistemleri).
• Daha önceki belirti Gözlemleri, bir sonraki güncellenmelerinde Anpheros konsept kodlamasını alır.

İlgili Konular

• Anpheros Semptom Motoru: metodoloji: kavramların nasıl atandığı, kontrol edildiği ve değerlendirildiği
• Anpheros Arama: semptomlar, durumlar ve tedaviler üzerinde kaynaklarla birlikte tek bir arama
• FHIR kod sistemleri: kaynak türüne göre her kod sistemi
• Boylamsal hasta verileri API
• FHIR R4 kullanarak tıbbi kayıtların nasıl saklanacağı
• FHIR platformu

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