للمطورين

# ربط ⁨Hysio⁩ بنظام السجل الطبي الإلكتروني لديك.

يبقى نظام السجل الطبي الإلكتروني لديك بيئة العمل. يمكنك بدء المعالجة عبر ⁨Hysio⁩ واستلام النتيجة، على أن يراجعها الممارس الصحي قبل نقلها إلى الملف.

[عرض وثائق ⁨API⁩](https://api.staging.server03.hysio.nl/apidocs/) [فتح ⁨Playground⁩](https://epd.hysio.nl)

تواصل مباشر samenwerking@hysio.nl

[مسارات التكامل](https://hysio.nl/ar/connect/#integratieroutes) [البداية التقنية](https://hysio.nl/ar/connect/#documentatie) [Playground](https://hysio.nl/ar/connect/#playground) [الوصول للاختبار](https://hysio.nl/ar/connect/#toegang)

## اختيار المسار المناسب لنظامك

يمكنك إسناد الإدخال إلى ⁨Hysio⁩ أو استخدام واجهتك الخاصة. وفي المسارين كليهما، يبقى القرار لك في طريقة معالجة النتيجة داخل نظام السجل الطبي الإلكتروني لديك.

### جلسة مستضافة

يمكنك بدء جلسة عبر ⁨API⁩ وفتح رابط ⁨Hysio⁩ الوارد في الاستجابة. وهناك يسجل الممارس الصحي المحادثة أو يدخل نصًا، ثم ينهي الجلسة.

- يتولى ⁨Hysio⁩ الإدخال والمعالجة.

- يصلك تقرير أولي للمراجعة، وبيانات ⁨JSON⁩ منظمة عند توفرها.

### إرسال النص عبر API

يمكنك إبقاء إدخال النص في واجهتك الخاصة، وإرساله إلى ⁨Hysio⁩، ثم استلام النتيجة عبر ⁨API⁩.

- إدارة الواجهة والنص المرسل بيدك.

- تصف وثائق ⁨API⁩ المدخلات والحالات وحقول النتيجة.

## من الجلسة إلى المكان الصحيح في الملف

يحافظ نظام السجل الطبي الإلكتروني لديك على الترابط بين الممارس الصحي ولقاء الرعاية والملف. أما ⁨Hysio⁩ فيدعم التوثيق.

- ### البدء من نظامك

يمكنك اختيار أحد المساعدين بالذكاء الاصطناعي المتاحين. ثم يلزم حفظ مرجع الجلسة مع لقاء الرعاية المعني في نظامك الخاص.
 
- ### تقديم المدخلات

يمكنك فتح الجلسة المستضافة أو إرسال نص عبر ⁨API⁩. ويحول ⁨Hysio⁩ المدخلات إلى تقرير أولي للمراجعة.
 
- ### استلام النتيجة

يمكنك استلام ⁨postback⁩ على ⁨endpoint⁩ الخاص بك أو استرجاع النتيجة. ثم يُربط مرجع الجلسة بلقاء الرعاية المقابل.
 
- ### مراجعة التقرير الأولي

يُعرض التقرير الأولي على الممارس الصحي ليراجع محتواه ويعدله عند الحاجة.
 
- ### نقل النص

يمكنك إدراج النص بعد مراجعته في حقول الملف المناسبة، مع مواءمة الحقول وتعيينها وفق مخرجات المساعد بالذكاء الاصطناعي المختار.

## نقطة انطلاق عملية لتكاملك

يمكنك البدء بالاستعلام عن المساعدين بالذكاء الاصطناعي المتاحين، ثم بدء جلسة اختبار. ويرجى استبدال العناصر النائبة في المثال بعنوان ⁨URL⁩ الأساسي ومعرف متاح ومفتاح ⁨API⁩ الخاص بك. كما يلزم استبدال عنوان ⁨postback⁩ الوهمي بعنوان ⁨endpoint⁩ الخاص بك.

عنوان ⁨URL⁩ الأساسي للاختبار` https://api.staging.server03.hysio.nl/api/v1 `

[مرجع ⁨API⁩](https://api.staging.server03.hysio.nl/apidocs/) [تنزيل ⁨OpenAPI⁩](https://api.staging.server03.hysio.nl/apidocs/openapi.yaml) [دليل التكامل (⁨PDF⁩)](https://api.staging.server03.hysio.nl/apidocs/epd-integratie.pdf)

يتضمن ملف ⁨PDF⁩ أيضًا أمثلة لبيئة الإنتاج. وللاختبار، يرجى استخدام عنوان ⁨staging⁩ الوارد أعلاه.

### بدء جلسة مستضافة

````
POST {base_url}/workflows/{workflow_id}/hosted-session
Authorization: Bearer {api_key}
Accept: application/json
Content-Type: application/json
Idempotency-Key: partner-test-voorbeeld-001

{
    "postback_url": "https://dossiersysteem.example/hysio/webhook",
    "collect_answers": true
}
````

يعيد الطلب الناجح ⁨HTTP 201⁩، ومن ضمن ما يعيده ⁨session\_id⁩ و⁨redirect\_url⁩ و⁨postback\_secret⁩. ولاستخدام الجلسة المستضافة، يلزم فتح ⁨redirect\_url⁩ دون أي تغيير، بما في ذلك المقطع الذي يلي العلامة \#.

### استلام postback

````
{
    "session_id": 1841,
    "idempotency_key": "partner-test-voorbeeld-001",
    "status": "completed",
    "output": "## Subjective\nFictional example text from the conversation.",
    "output_json": {
        "subjectief": "Fictional example text from the conversation."
    },
    "output_json_status": "ready"
}
````

مثال ⁨webhook⁩ مختصر ووهمي. وتعتمد الحقول داخل ⁨output\_json⁩ على المساعد بالذكاء الاصطناعي المختار. واكتمال الجلسة لا يعني تلقائيًا توفر بيانات ⁨JSON⁩ منظمة.

### اكتشاف ما هو متاح

يمكنك استدعاء ⁨GET /workflows⁩ بمفتاح ⁨API⁩ الخاص بك، ثم استخدام معرف (⁨id⁩) المساعد بالذكاء الاصطناعي المختار بوصفه ⁨workflow\_id⁩ في المثال. ويرتبط الوصول بحسابك.

### التحقق من postback

يلزم التحقق من ⁨X-Hysio-Signature⁩: القيمة ⁨sha256=⁩ تليها قيمة ⁨HMAC-SHA256⁩ لجسم الطلب دون أي تعديل، محسوبة باستخدام ⁨postback\_secret⁩ المستلم. ويجب رفض أي توقيع غير صالح، وحفظ هذا السر على خادمك.

### معالجة JSON بوعي

يلزم التحقق من ⁨output\_json\_status⁩ قبل معالجة ⁨JSON⁩. فالحالة ⁨pending⁩ تعني أن التحويل لم يكتمل بعد، والحالة ⁨not\_configured⁩ تعني أنه لم تُضبط مخرجات ⁨JSON⁩. ويجب أيضًا مراعاة أخطاء المعالجة.

### إعادة الطلب بعناية

عند إعادة إرسال طلب البدء نفسه، يُستخدم ⁨Idempotency-Key⁩ نفسه. أما الجلسة الجديدة فتستلزم قيمة جديدة.

Hysio Playground

## بيئة اختبار لأنظمة السجلات الطبية الإلكترونية

يعرض نظام سجل طبي إلكتروني افتراضي كيف تبدأ الجلسة وكيف تعود النتيجة. وبذلك يمكنك استكشاف آلية العمل قبل بناء تكاملك بنفسك.

يُفتح ⁨Playground⁩ بكود وصول. ليس لديك كود بعد؟ يمكنك طلب الوصول للاختبار أدناه. وكود الوصول ليس مفتاح ⁨API⁩.

[فتح ⁨Playground⁩](https://epd.hysio.nl) [طلب الوصول للاختبار](https://hysio.nl/ar/connect/#contact)

يرجى استخدام بيانات وهمية فقط. ⁨Playground⁩ بيئة اختبار، ولا يكتب في أي نظام سجل طبي إلكتروني حقيقي.

## من الوصول للاختبار إلى أول استدعاء API

للاختبار المستقل، يُستخدم حساب اختبار في ⁨Hysio⁩ ومفتاح ⁨API⁩ خاص بك. وننسق معك ترتيبات الوصول.

- ### طلب الوصول للاختبار

يمكنك إخبارنا بنظام السجل الطبي الإلكتروني الذي يستهدفه تطويرك، وبما يهمك اختباره. وسنساعدك في الحصول على الوصول والوثائق المناسبة.

- ### ترتيب الوصول إلى API

يمكنك تنسيق الوصول للاختبار معنا. وسنساعدك في الحصول على حساب اختبار ووصول مناسب إلى ⁨API⁩. ويحتاج مفتاح ⁨API⁩ إلى الصلاحيات ⁨workflows:read⁩ و⁨sessions:create⁩ و⁨sessions:read⁩.

- ### الاختبار بمدخلات وهمية

يمكنك استخدام عنوان ⁨URL⁩ لبيئة ⁨staging⁩، والاستعلام عن المساعدين بالذكاء الاصطناعي المتاحين، وإجراء جلسة من بدايتها إلى نهايتها. ويرجى التحقق أيضًا من رسائل الخطأ ومن طريقة تسليم النتيجة.

يعمل مفتاح ⁨API⁩ نيابة عن حسابك في ⁨Hysio⁩. ولا يظهر المفتاح كاملًا إلا عند إنشائه. ويجب حفظ المفتاح على خادمك وعدم إدراجه في كود الواجهة الأمامية أو ملفات السجل أو الأمثلة المنشورة علنًا.

[الأمان ومعالجة البيانات](https://hysio.nl/ar/veiligheid/)[المستندات القانونية (باللغة الهولندية)](https://trustcentre.hysio.nl/)

## ما الذي يهمك ربطه؟

يمكنك مشاركة سؤالك التقني أو طلب الوصول إلى ⁨Playground⁩. ونبحث معك المسار المناسب لنظام السجل الطبي الإلكتروني لديك.

هل مراسلتنا مباشرة بالبريد الإلكتروني أنسب لك؟
samenwerking@hysio.nl

هل أنت من الممارسين الصحيين؟

هل يهمك معرفة ما هو ممكن لعيادتك؟ يمكنك إخبارنا بنظام السجل الطبي الإلكتروني لديك، وعندها نناقش معك الإمكانات الحالية.

[التواصل معنا](https://hysio.nl/ar/contact/?onderwerp=koppeling)