جلسة مستضافة
يمكنك بدء جلسة عبر API وفتح رابط Hysio الوارد في الاستجابة. وهناك يسجل الممارس الصحي المحادثة أو يدخل نصًا، ثم ينهي الجلسة.
- يتولى Hysio الإدخال والمعالجة.
- يصلك تقرير أولي للمراجعة، وبيانات JSON منظمة عند توفرها.
للمطورين
ربط Hysio بنظام السجل الطبي الإلكتروني لديك.
يبقى نظام السجل الطبي الإلكتروني لديك بيئة العمل. يمكنك بدء المعالجة عبر Hysio واستلام النتيجة، على أن يراجعها الممارس الصحي قبل نقلها إلى الملف.
تواصل مباشر samenwerking@hysio.nl
اختيار المسار المناسب لنظامك
يمكنك إسناد الإدخال إلى Hysio أو استخدام واجهتك الخاصة. وفي المسارين كليهما، يبقى القرار لك في طريقة معالجة النتيجة داخل نظام السجل الطبي الإلكتروني لديك.
إرسال النص عبر API
يمكنك إبقاء إدخال النص في واجهتك الخاصة، وإرساله إلى Hysio، ثم استلام النتيجة عبر API.
- إدارة الواجهة والنص المرسل بيدك.
- تصف وثائق API المدخلات والحالات وحقول النتيجة.
من الجلسة إلى المكان الصحيح في الملف
يحافظ نظام السجل الطبي الإلكتروني لديك على الترابط بين الممارس الصحي ولقاء الرعاية والملف. أما Hysio فيدعم التوثيق.
البدء من نظامك
يمكنك اختيار أحد المساعدين بالذكاء الاصطناعي المتاحين. ثم يلزم حفظ مرجع الجلسة مع لقاء الرعاية المعني في نظامك الخاص.
تقديم المدخلات
يمكنك فتح الجلسة المستضافة أو إرسال نص عبر API. ويحول Hysio المدخلات إلى تقرير أولي للمراجعة.
استلام النتيجة
يمكنك استلام postback على endpoint الخاص بك أو استرجاع النتيجة. ثم يُربط مرجع الجلسة بلقاء الرعاية المقابل.
مراجعة التقرير الأولي
يُعرض التقرير الأولي على الممارس الصحي ليراجع محتواه ويعدله عند الحاجة.
نقل النص
يمكنك إدراج النص بعد مراجعته في حقول الملف المناسبة، مع مواءمة الحقول وتعيينها وفق مخرجات المساعد بالذكاء الاصطناعي المختار.
نقطة انطلاق عملية لتكاملك
يمكنك البدء بالاستعلام عن المساعدين بالذكاء الاصطناعي المتاحين، ثم بدء جلسة اختبار. ويرجى استبدال العناصر النائبة في المثال بعنوان URL الأساسي ومعرف متاح ومفتاح API الخاص بك. كما يلزم استبدال عنوان postback الوهمي بعنوان endpoint الخاص بك.
عنوان URL الأساسي للاختبار
https://api.staging.server03.hysio.nl/api/v1يتضمن ملف 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 بيئة اختبار، ولا يكتب في أي نظام سجل طبي إلكتروني حقيقي.
من الوصول للاختبار إلى أول استدعاء API
للاختبار المستقل، يُستخدم حساب اختبار في Hysio ومفتاح API خاص بك. وننسق معك ترتيبات الوصول.
طلب الوصول للاختبار
يمكنك إخبارنا بنظام السجل الطبي الإلكتروني الذي يستهدفه تطويرك، وبما يهمك اختباره. وسنساعدك في الحصول على الوصول والوثائق المناسبة.
ترتيب الوصول إلى API
يمكنك تنسيق الوصول للاختبار معنا. وسنساعدك في الحصول على حساب اختبار ووصول مناسب إلى API. ويحتاج مفتاح API إلى الصلاحيات workflows:read وsessions:create وsessions:read.
الاختبار بمدخلات وهمية
يمكنك استخدام عنوان URL لبيئة staging، والاستعلام عن المساعدين بالذكاء الاصطناعي المتاحين، وإجراء جلسة من بدايتها إلى نهايتها. ويرجى التحقق أيضًا من رسائل الخطأ ومن طريقة تسليم النتيجة.
يعمل مفتاح API نيابة عن حسابك في Hysio. ولا يظهر المفتاح كاملًا إلا عند إنشائه. ويجب حفظ المفتاح على خادمك وعدم إدراجه في كود الواجهة الأمامية أو ملفات السجل أو الأمثلة المنشورة علنًا.
ما الذي يهمك ربطه؟
يمكنك مشاركة سؤالك التقني أو طلب الوصول إلى Playground. ونبحث معك المسار المناسب لنظام السجل الطبي الإلكتروني لديك.
هل مراسلتنا مباشرة بالبريد الإلكتروني أنسب لك؟
samenwerking@hysio.nl
هل أنت من الممارسين الصحيين؟
هل يهمك معرفة ما هو ممكن لعيادتك؟ يمكنك إخبارنا بنظام السجل الطبي الإلكتروني لديك، وعندها نناقش معك الإمكانات الحالية.
التواصل معنا