مختبر واحد لديه مهمة واحدة في عملية التكامل: إدخال التقرير في سجل المريض دون إعادة كتابة، ودون فقدان نطاق المرجع، ودون اختراع تنسيق لا يقرأه أحد غيره. موصل مختبر Anpheros يأخذ التقرير كما ينتجه المختبر بالفعل، بصيغة HL7 v2 أو CSV أو JSON، ويحول كل نتيجة إلى Observation في FHIR مع رمز LOINC، ووحدة قياس، ونطاق مرجع، وتاريخ، واسم المختبر كمنفذ. هذا الدليل هو العقد.
نسخة تقنية للمطورين: موصل المختبر · واجهة برمجة تطبيقات نتائج المختبر على developers.anpheros.com، مع الطلبات والاستجابات والحدود. هذه الصفحة هي النسخة بلغة بسيطة.
طلب واحد
POST /v1/patients/{patient_id}/labs/import
Authorization: Bearer <project key>
Content-Type: text/csv | x-application/hl7-v2+er7 | application/json
X-Anpheros-Source-System: labx (اختياري؛ مسجل في Provenance)
Idempotency-Key: <report id> (اختياري؛ إعادة المحاولة تعطي نفس الإجابة)
الاستجابة تقول ما حدث:
{"created": 3, "skipped": 0, "unmapped": ["Marker foarte rar"], "warnings": [],
"observations": [{"id": "…", "marker": "TSH", "code": "3016-3", "system": "http://loinc.org",
"value": 2.1, "unit": "mUI/L", "date": "2026-09-01"}]}
التنسيقات
HL7 v2 ORU^R01، كنص ER7. OBX-3 هو المعرف (code^text^LN هو LOINC؛ يتم الاحتفاظ بالرمز المحلي كرمز المختبر الخاص)، OBX-5 القيمة، OBX-6 الوحدة، OBX-7 نطاق المرجع، OBX-8 علامة الشذوذ (تصبح interpretation)، OBX-11 الحالة، OBX-14 أو OBR-7 التاريخ. MSH-4 يسمي المنشأة المرسلة، والتي تصبح المنفذ؛ OBR-3 و MSH-10 يصبحان معرف التقرير في Provenance. النتائج المعلقة أو المحذوفة أو الخاطئة (I، X، D، W) ومقاطع OBX بدون قيمة لا تصبح Observations ويتم تسميتها في warnings.
CSV مع صف رأس؛ الفواصل , ; أو علامة جدولة، فاصلة عشرية مقبولة، تواريخ ISO، DD.MM.YYYY أو DD/MM/YYYY. الأعمدة المعترف بها باللغة الرومانية أو الإنجليزية: marker، value، unit، reference range (70-100، <5، >3.5) أو ref_low/ref_high، date، رمز LOINC اختياري، note. يحمل ملف CSV بيانات المختبر، لذلك يكون المنفذ مفقودًا ما لم ترسل X-Anpheros-Acting-As.
Analiza;Rezultat;UM;Interval de referinta;Data
Hemoglobina glicozilata (HbA1c);6,4;%;4,0-5,6;01.09.2026
TSH;2,1;mUI/L;0,4-4,0;01.09.2026
JSON عندما يكون لديك بالفعل بيانات منظمة: {"date": "2026-09-01", "origin": "report-77", "laboratory": "Synevo", "items": [{"marker": "TSH", "value": 2.1, "unit": "mUI/L", "ref_low": 0.4, "ref_high": 4.0, "code": "3016-3"}]}.
قواعد الربط التي تهم
- LOINC عند توفيره، وإلا بالاسم. تتم مطابقة الأسماء مع أسماء LOINC والمرادفات باللغة الرومانية والإنجليزية. الاسم الذي يتطابق مع مفاهيم متعددة، أو يحمل مؤهلاً لا يملكه المفهوم (بول، غير HDL، حر، نسبة)، لا يتم تخمينه: يتم الاحتفاظ برمز المختبر الخاص به تحت
urn:anpheros:lab-codeويظهر فيunmapped، حتى تتمكن من تحسين الربط من جانبك. أرسل رموز LOINC كلما كانت لديك. - لا يتم تحويل القيم أبدًا. اليوريا ونيتروجين اليوريا رموز مختلفة؛ LDL المباشر و LDL المحسوب رموز مختلفة؛ الجلوكوز من المصل ومن الدم الشعري رموز مختلفة. يختار الموصل الرمز الصحيح من الاسم والطريقة، ويترك الرقم كما هو.
- الأوقات تحتفظ بمنطقتها الزمنية. يتم الاحتفاظ بوقت v2 مع إزاحة؛ بدونها، يتم استخدام إزاحة
MSH-7مع تحذير؛ بدون أي إزاحة في أي مكان، يتم تخزين التاريخ فقط. تحمل أوقات CSV أي منطقة زمنية ويتم تخزينها كتاريخ. - متطابق. أرسل نفس التقرير مرتين بنفس
Idempotency-Keyوستحصل على نفس الإجابة ولا توجد تكرارات. - Provenance على كل نتيجة: نظام المصدر، معرف التقرير، والمنفذ، كما يتطلب HL7 Europe Laboratory Report.
ما يراه المريض
تظهر النتائج في سجل الشخص، وإذا كانوا يستخدمون Anpheros Daily، على هواتفهم فور وصولها، مع نطاق المرجع والاتجاه على مدار التقارير السابقة. لا شيء للمسح، لا شيء لإعادة الكتابة. إذا كانت النتيجة غير طبيعية، يرى الشخص العلامة؛ التطبيق لا يفسرها.
الاختبار
بيئة الاختبار مجانية والمرضى الاصطناعيون لديهم بالفعل تاريخ مختبري. أرسل تقريرًا لأحد هؤلاء المرضى واقرأه مرة أخرى:
curl -X POST "$BASE/v1/patients/$PID/labs/import" -H "Authorization: Bearer $KEY" \
-H "Content-Type: text/csv" --data-binary @report.csv
curl "$BASE/fhir/R4/Observation?patient=$PID&category=laboratory&_sort=-date" -H "Authorization: Bearer $KEY"
المواصفات الكاملة، بما في ذلك ملاحظات التوافق مع HL7 Europe، موجودة على developers.anpheros.com/guides/lab-connector.
الأسئلة الشائعة
هل يجب علينا تغيير ما ينتجه نظام معلومات المختبر (LIS) لدينا؟
لا. أرسل رسالة ORU^R01 أو تصدير CSV كما هي. إذا كان بإمكانك إضافة رموز LOINC، فافعل ذلك؛ وإلا فإن الموصل يربط بالاسم ويخبرك بما لم يتمكن من ربطه.
ماذا عن النتائج التي لا يمكنك ربطها؟
يتم تخزينها مع رمز المختبر الخاص والنص الدقيق من التقرير، لذلك لا شيء مفقود، ويتم سردها في unmapped حتى تتمكن من إضافة رمز LOINC في المرة القادمة.
هل يتم الاحتفاظ بنطاقات المرجع وعلامات الشذوذ؟
نعم: يذهب النطاق إلى referenceRange، والعلامة إلى interpretation، ويتم تخزين الوحدة كـ UCUM، ولا يتم تحويل القيمة أبدًا.
هل يمكن للمختبر إرسال نتائج لمريض لم ينشئه؟
فقط بموافقة الشخص، أو كمنظمة يتصرف المشروع نيابة عنها مع X-Anpheros-Acting-As. يرى المشروع المرضى الذين أنشأهم؛ كل شيء آخر يتطلب إذنًا.
هل هناك تكلفة للتكامل؟
بيئة الاختبار مجانية. يبدأ الإنتاج بـ 49 يورو شهريًا لكل منظمة، مع الشهر الأول مجانًا؛ انظر التسعير.
احتفظ بسجلك الطبي معك
يجمع Anpheros Daily الأعراض، نتائج المختبر، الأدوية، والمستندات في مكان واحد، بتنسيق قياسي، تحت سيطرتك. الخطة الأساسية مجانية.