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

واجهة برمجة تطبيقات بيانات الأعراض: المفاهيم، مصطلحات FHIR، وأعراض يبلغ عنها المريض

معرفات أعراض ثابتة مرتبطة بـ ICD-10، تُقدم كـ REST وكـ FHIR CodeSystem، ValueSet، و ConceptMap؛ كيف تبدو ملاحظة (Observation) لأعراض يبلغ عنها المريض وكيفية التحقق من صحتها.

يقدم Anpheros لكل عرض معرفًا مستقرًا (SYM-0047 هو الصداع)، ويربطه بـ ICD-10، ويقدم القائمة عبر نقطة نهاية REST وكـ FHIR R4 terminology (CodeSystem، ValueSet، ConceptMap، $lookup). الأعراض التي يبلغ عنها المرضى تُخزن كـ FHIR Observations تحمل كلا الرمزين، وكلمات الشخص الخاصة، وشدة العرض، وعند معرفتها، متى بدأ العرض وانتهى. تعرض هذه الصفحة كيفية العثور على مفهوم، وكيف يبدو عرض العرض الذي يبلغ عنه المريض، وكيفية التحقق من عرض كتبته بنفسك، وما لا تحتويه البيانات عمدًا.

ما يحتويه الإصدار

لا يتم إعادة استخدام المعرفات أبدًا. يبقى المفهوم الذي تم سحبه في القائمة مع 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 يطابق معرف المفهوم، ورموز 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، أو wider عندما يغطي رمز ICD-10 أكثر من المفهوم (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 تعمل بنفس الطريقة.

ما لا يتم نشره أبدًا كعرض

فقط الأعراض الموجودة و المتعلقة بالمريض تصبح ملاحظات (Observations)، وفقط بعد تطبيع النص الحر. "لم يعد رأسي يؤلمني"، "ربما حمى غدًا"، "والدتي لديها سعال" أو نص لم يتمكن المُطبع من قراءته لا يصبح عرضًا للمريض؛ إذا تم تصحيح عرض منشور لاحقًا إلى أحد هذه، فسيتم سحب ملاحظته (حذف ناعم - يبقى السجل). شكاوى الأقارب لا تتحول إلى تاريخ عائلي تلقائيًا.

التحقق من عرض تكتبه

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: الإسهال والإمساك) وتم التحقق منها مقابل تلك الصفحات في 15 أكتوبر 2026. يحمل كل عنصر عنوان المصدر الخاص به (context)، ونصيحته (quote)، والمجموعة التي ينطبق عليها (applies_to)، والمصدر مع الترخيص والإسناد، review: source_verified والملاحظة بأنه ليس تشخيصًا ولم تتم مراجعته من قبل طبيب. المصادر أمريكية: حيث تذكر اقتباس 9-1-1، تضيف الملاحظة أن رقم الطوارئ في أوروبا هو 112.
• لا يتم تقديم أي أسباب أو ارتباطات للحالات: يظل associations فارغًا حتى يقوم طبيب بمراجعة عنصر ما. الارتباط دائمًا هو "قد يرتبط بـ".
• تُكتب رموز SNOMED CT فقط حيث يسمح الترخيص بذلك (انظر أنظمة رموز FHIR).
• تتلقى ملاحظات الأعراض السابقة ترميز مفهوم Anpheros في المرة التالية التي يتم فيها تحديثها.

ذات الصلة

• محرك أعراض Anpheros: المنهجية: كيفية تعيين المفاهيم والتحقق منها وتقييمها
• بحث Anpheros: بحث واحد عن الأعراض والحالات والعلاجات، مع المصادر
• أنظمة رموز FHIR: كل نظام رموز لكل نوع مورد
• واجهة برمجة تطبيقات بيانات المرضى الطولية
• كيفية تخزين السجلات الطبية باستخدام FHIR R4
• منصة FHIR

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