دليل المستخدم MedWand Telemedicine API V2.x

دليل المستخدم MedWand Telemedicine API V2.x


مرحبا بكم

مرحبا بكم في MedWand Telemedicine API الإصدار 2.x

تقدم MedWand مجموعة من موارد واجهة برمجة التطبيقات المدمجة مسبقًا والتي يمكنك استخدامها لدمج منصة MedWand VirtualCare مع نظامك الحالي. من خلال الاستفادة من موارد واجهة برمجة التطبيقات المدمجة مسبقًا ، يمكنك ضرب الأرض التي تعمل بوتيرتك الخاصة. إذا وجدت أن موارد واجهة برمجة التطبيقات المدمجة مسبقًا لا تتناسب مع احتياجاتك ، فيمكننا العمل معك لإنشاء مجموعة مخصصة من نقاط النهاية.

لماذا لا يعمل "patientUrl" كما هو متوقع؟

"patientUrl" فريدة من نوعها من حيث أنها تعمل بشكل مختلف بكثير عن "doctorUrl" و "guestUrl". في حين أن "doctorUrl" و "guestUrl" هما عنوان URL نموذجي يمكن التنقل إليه عبر علامة مرساة أو JavaScript أو لصقه في شريط عناوين المتصفح أو تنفيذه من تطبيق مجمع.
لا يمكن التنقل في "patientUrl" إلا عبر علامة مرساة نقرها المستخدم أو JavaScript أو تنفيذه من تطبيق تم تجميعه.
يجب أن يكون هذا أيضًا على الجهاز المحمول المتصل بجهاز أجهزة MedWand ولديه تطبيق MedWand VirtualCare Android Client المثبت.

سيتم اعتراض "patientUrl" ، عند التنقل عبر إحدى الطرق الموضحة أعلاه ، بواسطة نظام تشغيل Android ، وسيفتح تلقائيًا تطبيق MedWand VirtualCare Client عبر واجهة المستخدم الداخلية ، لبدء الامتحان. نظرًا لقيود المتصفحات على الأجهزة المحمولة ، لا يقوم المتصفح بتشغيل تطبيق خارجي لعنوان URI معين في الحالات التالية.

  • عندما يتم إعادة توجيه واجهة المستخدم المستهدفة من عنوان Url مكتوب.
  • عندما يتم بدء Uri المستهدف دون لفتة المستخدم.

لهذا السبب ، لا يمكن استخدام "patientUrl" إلا عبر إحدى الطرق الموضحة أعلاه. إذا حاولت استخدام "patientUrl" بأي طريقة أخرى ، فسيتم إرسالك إلى صفحة في المتصفح تقول ، "يجب تشغيل نوع الامتحان هذا من جهاز MedWand اللوحي".

التكوين

التكوين

هذه المعلومات مطلوبة قبل أن نتمكن من إصدار رمز Api الخاص بك. بمجرد حصولك على هذه المعلومات ، يمكنك طلب رمز واجهة برمجة التطبيقات الخاص بك في علامة التبويب "البدء".
عنوان Url للعودة

عنوان URL للعودة إلى api الخاص بك. هذا هو URI الذي تريد إرسال نتائج امتحانك إليه بعد اكتمال الامتحان.

نوع رد الفعل

هناك 4 خيارات لتلقي معلومات الامتحان.

  1. لا شيء:

    لن تتلقى أي إشعار عند الانتهاء من الامتحان. هذا الخيار جيد للأنظمة التي تستخدم فيها نظام MedWand VirtualCare فقط ولا تخزن النتائج.

  2. كامل:

    ستتلقى كائن json يحتوي على الامتحان الكامل بتنسيق Json إلى CallbackUrl الذي تقدمه.

  3. Html:

    ستحصل على كائن JSON يحتوي على الامتحان الكامل بتنسيق HTML إلى CallbackUrl الذي تقدمه.

نوع مصادقة Callback

هناك 4 خيارات لمصادقة استعادة المكالمة الخاصة بنا إلى api الخاص بك.

  1. لا شيء:

    لا يلزم الحصول على رأس تفويض أو خصائص.

  2. سر المفتاح:

    تتم إضافة المفتاح والسر المقدم إلى الرأس عبر مفتاح "المفتاح" و "السر"أزواج القيمة.

  3. تحمل:

    سيتم إضافة الرمز المميز المقدم إلى الرأس عبر مفتاح "الإذن" مع القيمة المسبقة بـ "حامل".

  4. ApiToken:

    سيتم إضافة الرمز المميز المقدم إلى الرأس عبر مفتاح "ApiToken".

  5. مخصص:

    سيتم إضافة الرمز المميز المقدم إلى الرأس عبر مفتاحك المخصص.

قيمة إذن استعادة المكالمات

يتم استخدام قيمة إذن عنوان URL مرة أخرى جنبًا إلى جنب مع نوع مصادقة Callback المحدد.

البدء

البدء

مطلوب معلومات من علامة التبويب "التكوين" قبل أن نتمكن من إصدار رمز Api الخاص بك. بمجرد حصولك على هذه المعلومات ، يمكنك طلب رمز api الخاص بك.
الخطوة 1: اطلب رمز واجهة برمجة تطبيقات Sandbox الخاص بك

للبدء ، يجب عليك طلب حساب Sandbox لشركتك. يتم ذلك من خلال شخص المبيعات الخاص بك.

بمجرد حصولك على حساب Sandbox:

  1. اطلب من رمز Api الخاص بك البدء في الاختبار بالنقر فوق الرابط أدناه لطلب مفاتيحك.
  2. سنقوم بعد ذلك بالاتصال بك لطلب أي معلومات إضافية مطلوبة من قسم "التكوين". يرجى عدم تقديم هذه المعلومات في نموذج طلب مفاتيح api.
  3. سيتم تحديث حسابك وسيتم إرسال رمز Api الخاص بك مباشرة إلى جهة الاتصال الفنية الخاصة بك.
اطلب مفتاح Api-يرجى مراجعة قسم التكوين قبل طلب مفتاح Api الخاص بك. سيُطلب منك تقديم إعدادات التكوين الخاصة بك ضمن طلب تذكرة الدعم قبل إنشاء مفتاح api.
الخطوة 2: أدوات اختبار واجهة برمجة التطبيقات

يوصي MedWand ويستخدم Postman أو الأرق لجميع اختبارات واجهة برمجة التطبيقات. الأرق هو أكثر قدرة على التعامل مع الطلبات والاستجابات الكبيرة التي يمكن أن تكون هي الحال مع بعض نتائج الامتحانات. على الرغم من أنك قد تستخدم أي أداة ترغب فيها ، إلا أن استخدام الأرق سيسمح لنا بمساعدتك بشكل أفضل إذا لزم الأمر. يمكنك تنزيل وتثبيت Insomnia منهنا.

الخطوة 3: الاختبار الأول

سيكون أول اختبار لك هو استرداد استجابة نبضات القلب من خادم api. للقيام بذلك ، اتبع هذه الخطوات:

كورل

curl --l الموقع"https://api.medwand.cloud/heartbeat'

رجل البريد

  1. إضافة طلب جديد في Postman.
  2. حدد "Get" كنوع الطريقة.
  3. ادخل "https://api.medwand.cloud/heartbeat"كما عنوان Url.
  4. في علامة التبويب "الإذن" ، قم بتعيين النوع إلى "لا Auth".
  5. انقر فوق الزر "إرسال".

الرد

{
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": "الإصدار: 2.0.6.104 بناء: 2026.3.12.246",
"actionDateUtc": "2026-03-18T21:31:39.8353597Z",
"البيئة": "صندوق الرمال"
}
Flowchart

Flowchart

يغطي الرسم البياني للتدفق أدناه جميع أنواع الامتحانات الثلاثة (المريض وOnSite والبعيد) التي يمكنك استخدامها.

بمجرد أن يكون لديك فهم جيد للتدفق ، فأنت مستعد للبدء في استخدام واجهة برمجة التطبيقات الافتراضية الخاصة بنا لدمج نظام الرعاية الافتراضية MedWand مع منصة PMS / EHR الحالية.


التعيينات

التعيينات

Post: إنشاء موعدك.

طلب cUrlستحتاج إلى إدراج ApiToken في الرأس أدناه وإلا فإن الطلب سيفشل باعتباره "غير مصرح به".


curl --l الموقع"https://api.medwand.cloud/default/v2/appointment/create'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"doctorName": "دكتورة جين الطبية"،
"patientName": "جون دو"،
"examType": "في الموقع"،
"جدولةStartDateUtc": "2026-03-19T15:51:49.780Z",
"المدة المجدولة": 30
}"

الرد


{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"patientUrl": "https://api.medwand.cloud?platform=api.medwand.cloud&token=GFXwMZiRTka6jVlq_zNhOQ",
"دكتور أورل": ",
"guestUrl": ",
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": ",
"actionDateUtc": "2026-03-19T15:51:49.780Z",
"البيئة": "صندوق الرمال"
}
Post: تحديث موعدك.

طلب cUrlستحتاج إلى إدراج ApiToken في الرأس أدناه وإلا فإن الطلب سيفشل باعتباره "غير مصرح به".


curl --l الموقع"https://api.medwand.cloud/default/v2/appointment/update'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"doctorName": "الدكتور جين فوكس"،
"patientName": "روبرت دو"،
"examType": "بعيدة"،
"جدولةStartDateUtc": "2026-03-19T15:51:49.780Z",
"المدة المجدولة": 30
}"

الرد


{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"patientUrl": "https://client.medwand.cloud?platform=api.medwand.cloud&token=GFXwMZiRTka6jVlq_zNhOQ",
"دكتور أورل": "https://examroom.medwand.cloud?platform=api.medwand.cloud&token=hkzBXDrXW0KH04ByCdxK-w",
"guestUrl": "https://examroom.medwand.cloud/Guest?platform=api.medwand.cloud&token=bz09_6hmXUWIyRy2sHK4bg",
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": ",
"actionDateUtc": "2026-03-19T15:51:49.780Z",
"البيئة": "صندوق الرمال"
}
الوسم: حذف موعدك.

طلب cUrlستحتاج إلى إدراج ApiToken في الرأس أدناه وإلا فإن الطلب سيفشل باعتباره "غير مصرح به".


curl --l الموقع"https://api.medwand.cloud/default/v2/appointment/delete'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"
}"

الرد


{
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": ",
"actionDateUtc": "2026-03-19T15:51:49.780Z",
"البيئة": "صندوق الرمال"
}
نتائج الامتحان

نتائج الامتحان

إشعار:ستحصل على كائن JSON بسيط إلى CallbackUrl الذي تقدمه.

كائن Json أدناه هو ما يتم إرساله إلى عنوان url للعودة الذي تقدمه.

  • الامتحان: هو الموعد الذي قدمته عند طلب الموعد.
  • endتاريخ: تاريخ / وقت الانتهاء من الامتحان بالتوقيت العالمي المنسق.
{
examId = "985397a-558b-456c-8c57-00dfd5af9b56"،
endDate = "2026-03-19T15:51:49.780Z"
}

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

Post: استرداد نتائج الامتحان الكاملة.

طلب cUrlستحتاج إلى إدراج ApiToken في الرأس أدناه وإلا فإن الطلب سيفشل باعتباره "غير مصرح به". إذا قمت بتعيين خاصية includeHtml صحيح ، فسيتضمن الرد نسخة HTML من نتائج الامتحان في خاصية HTMLDocument.


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/results'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"includingHtml": false
}"

الرد

انظر الرد الكامل أدناه.

Post: استرداد نتائج امتحان html.

طلب cUrlستحتاج إلى إدراج ApiToken في الرأس أدناه وإلا فإن الطلب سيفشل باعتباره "غير مصرح به".


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/html'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"
}"

الرد

انظر استجابة Html أدناه.

كامل:ستحصل على كائن Json يحتوي على نتائج الامتحان الكاملة.
  • التعيين: هو الموعد الذي قدمته عند طلب الموعد.
  • الطبيبالاسم: اسم الطبيب الذي قدمته عند طلب الموعد.
  • المريضاسم: اسم المريض الذي قدمته عند طلب الموعد.
  • examType: هناك 3 أنواع من الامتحانات (المريض ، في الموقع ، عن بعد) وهي حساسة للحالة.
  • doctorEnterDateUtc: التاريخ / الوقت الذي دخل فيه الطبيب الامتحان بالتوقيت العالمي المنسق.
  • patientEnterDateUtc: التاريخ / الوقت الذي دخل فيه المريض الامتحان بالتوقيت العالمي المنسق.
  • startDateUtc: التاريخ / الوقت الذي بدأ فيه الامتحان بالتوقيت العالمي.
  • endDateUtc: تاريخ / وقت الانتهاء من الامتحان بالتوقيت العالمي المنسق.
  • المدةدقائق: مدة الامتحان في دقائق.
  • الممارسNotes: ملاحظات أدخلها الطبيب.
  • المريضالملاحظات: ملاحظات تم إدخالها من قبل الممرضة / المريض.
  • htmlوثيقة: Html (بدون جافا سكريبت) تمثيل لنتائج الامتحان. انظرمثال مستند Html
  • القراءات: مجموعة من
    • sortOrder: الأمر الذي تم فيه اتخاذ القراءة.
    • deviceاسم: الاسم الرسمي للجهاز المستخدم لأخذ القراءة.
    • deviceنموذج: اسم نموذج الجهاز المستخدم لأخذ القراءة .
    • جهازSerial: العدد التسلسلي للجهاز المستخدم لأخذ القراءة.
    • الجهازالبرمجيات: نسخة البرامج الثابتة من الجهاز المستخدمة لأخذ القراءة.
    • استشعار: الاسم الرسمي للمستشعر .
    • الاستشعارId: معرف الجهاز المستخدم لأخذ القراءة .
    • الاستشعارووضع: الوضع الذي كان في جهاز الاستشعار أثناء القراءة.
    • الإعدادات الاستشعار: الإعدادات المطبقة على بيانات الاستشعار.
    • sensorData: النتيجة من قراءة المستشعر.

{
"appointmentId": "3e42582f-d2e5-45f6-a0cb-81a61e430f42"،
"doctorName": "دكتور شارلوت مايرز"،
"patientName": "إيليا رينولدز"،
"examType": "بعيدة"،
"doctorEnterDateUtc": "2025-01-23T15:47:54.1365002",
"patientEnterDateUtc": "2025-01-23T15:48:54.2080408",
"startDateUtc": "2025-01-23T15:48:54.2080408",
"endDateUtc": "2025-01-23T15:57:56.346181",
"durationInminutes": "9"،
"practitionerNotes": "هذه هي ملاحظات الممارس خط 1 __email1__ nهذه هي ملاحظات الممارس خط 2 __email1__ nهذه هي ملاحظات الممارس خط 3" ،
"patientNotes": "هذه هي ملاحظات المريض خط 1 __email1__ nهذه هي ملاحظات المريض خط 2 __email1__ nهذه هي ملاحظات المريض 3"،
"htmlDocument": "",
"قراءات":
[
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"وضع الاستشعار": "المنظار الجلدي"،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 2
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "Ecg"،
"sensorId": "11)2103260000006A",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "data:image/png;base64,iVBORw0KGgoAAANSUhEUgAAN/oAAAI5CAYAACJX..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "ضغط الدم" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "120/80"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "LabNotes",
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "هذا هو خط الملاحظة المختبرية 1 __email1__ nth هذا هو خط الملاحظة المختبرية 2"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "GTTInitial"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "100"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "HeightScale" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "وحدة:بوصة"،
"sensorData": "65.0"
},
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "PulseRate" ،
"sensorId": "11)2103260000006A",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "101"
},
{
"الترتيب": 3
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"وضع الاستشعار": "المنظار الجلدي"،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "الكوليسترولHdl" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "400"
},
{
"Sort Order": 4
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "الرئتان" ،
"sensorSettings": "",
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "مقياس الحرارة"،
"sensorId": "11)2103260000006A",
"sensorMode": "افتراضي" ،
"sensorSettings": "وحدة:Fahrenheit"،
"sensorData": "97.2"
},
{
"SortOrder": 6,
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "منظار" ،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "Ecg"،
"sensorId": "11)2103260000006A",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "data:image/png;base64,iVBORw0KGgoAAANSUhEUgAAN+4AAAI5CAYAACnG..."
},
{
"الترتيب": 3
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "الرئتان" ،
"sensorSettings": "الموقع:UpperMidLeftThorax"،
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "التنفس"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "25.0"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "مستوى الألم"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "وحدة:عدية"،
"sensorData": "2"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "GTT2Hour"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "300"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "SpirometerFev1"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "22.0"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "WaistSize"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "وحدة:بوصة"،
"sensorData": "45.0"
},
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "القلب"،
"sensorSettings": "",
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "مقياس الجلوكوز"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "150"
},
{
"SortOrder": 2
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "القلب"،
"sensorSettings": "",
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "WeightScale"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"إعدادات الاستشعار": "وحدة: جنيه"،
"sensorData": "200.0"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "الكوليسترولمجموع"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "600"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "CholesterolLdl" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "500"
},
{
"SortOrder": 5,
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "البطن" ،
"sensorSettings": "",
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 2
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"وضع الاستشعار": "المنظار الجلدي"،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"Sort Order": 4
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "منظار" ،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"الاستشعار": "GTT1Hour"،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "200"
},
{
"SortOrder": 6,
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "البطن" ،
"sensorSettings": "",
"sensorData": "data:audio/mp3;base64,SUQzBAAAAAAIlRTU0UAAAAAAADTGF2ZjYwLjMuM..."
},
{
"Sort Order": 7
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "المنظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "البطن" ،
"إعدادات الاستشعار": "تخطي: UpperMidLeftThorax: لم أستطع أخذ هذا التسجيل بسبب مشكلة واجهتها أثناء محاولتي أخذ التسجيل. هذا هو سبب طويل لعدم أخذ التسجيل."،
"sensorData": "-"
},
{
"SortOrder": 1
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"الاستشعار": "SpO2"،
"sensorId": "11)2103260000006A",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "94"
},
{
"SortOrder": 5,
"اسم الجهاز": "جهاز MedWand" ،
"deviceModel": "جيل 2"،
"deviceSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2.1.0.2",
"استشعار": "منظار" ،
"sensorId": "11)2103260000006A",
"sensorMode": "منظار" ،
"sensorSettings": "",
"sensorData": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "SpirometerPef" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "11"
},
{
"SortOrder": 1
"deviceName": "الدخول اليدوي"،
"deviceModel": "--",
"deviceSerial": "MedWand App"،
"deviceFirmware": "--",
"استشعار": "SpirometerFvc" ،
"sensorId": "--",
"sensorMode": "افتراضي" ،
"sensorSettings": "",
"sensorData": "33.0"
}
[,
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": ",
"actionDateUtc": "2025-01-23T17:58:39.0298659Z",
"البيئة": "صندوق الرمال"
}
Html:ستحصل على كائن Json يحتوي على الامتحان الكامل بتنسيق html.
  • التعيين: هو الموعد الذي قدمته عند طلب الموعد.
  • htmlوثيقة: Html (بدون جافا سكريبت) تمثيل لنتائج الامتحان. انظرمثال مستند Html

{
"appointmentId": "985397aa-558b-456c-8c57-00dfd5af9b56"،
"htmlDocument": "...",
"actionResult": صحيح,
"actionResponse": "Success",
"actionMessages": ",
"actionDateUtc": "2026-03-19T15:51:49.780Z",
"البيئة": "صندوق الرمال"
}
التعافي من الفشل

معلومات التعافي من الفشل

الإخطار

سيتم إرسال بريد إلكتروني إلى فريق MedWand وجهات الاتصال الفنية على حسابك.

سنحتفظ بنتائج الامتحان لمدة 30 يومًا حتى تتمكن من استردادها بعد حدوث فشل. يمكنك إزالة نتائج الامتحان عبر مكالمة Api في أي وقت.

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

اطلب قائمة بنتائج الامتحان المتاحة


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/list'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__

اطلب نتيجة امتحان محددة


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/results'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "[APPOINTMENTID]"،
"includingHtml": false
}"

إعادة إرسال نتيجة امتحان محددة إلى CallbackUrl الخاص بك


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/callback/resend'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "[APPOINTMENTID]"
}"

إزالة نتيجة امتحان محددة من نظامنا


curl --l الموقع"https://api.medwand.cloud/default/v2/exam/results/remove'__email1__
--header 'نوع المحتوى: التطبيق/جيسون' __email1__
--header 'ApiToken: ' __email1__
--data'{
"appointmentId": "[APPOINTMENTID]"
}"
المعلومات التقنية

المعلومات التقنية

جيسون Case

بالنسبة للأنظمة التي تهم فيها قضية Json.

  • قد تكون جميع الطلبات التي تقدمها إلى api الخاصة بنا في أي غطاء تريده لأننا نقبل جميع التنسيقات.
    • حالة الإبل - على سبيل المثال الاسم الأول
    • حالة باسكال - على سبيل المثال الاسم الأول
    • ⚡ საკვანძო სიტყვები: اسم
    • الحالة السفلية - على سبيل المثال الاسم الأول
  • جميع الردود منا على طلباتك ستكون في حالة Camel.
    • حالة الإبل - على سبيل المثال الاسم الأول
  • جميع ردود الفعل الصادرة من نظام استعادة المكالمات لدينا إلى api الخاص بك ستكون في حالة باسكال.
    • حالة باسكال - على سبيل المثال الاسم الأول
  • جميع ملفات json الوضع غير المتصلة بالإنترنت ستكون في حالة الإبل. جميع ملفات json الوضع غير المتصلة بالإنترنت ستكون في حالة الإبل.
    • حالة الإبل - على سبيل المثال الاسم الأول

أنواع الامتحانات

هذه القيم حساسة للحالة

  • المريض: هذا هو الفحص الذاتي الذي يكتمله المريض فقط.
  • الموقع: هذا هو امتحان محلي أكمله ممارس (ممرضة وطبيب ، إلخ.).
  • عن بعد: هذا هو الامتحان الذي أنجزه الممارس (الممرضة ، الطبيب ، إلخ)من مكان بعيد.

أنواع الاستشعار

هذه هي أنواع أجهزة الاستشعار المتاحة جنبا إلى جنب مع أنواع الوحدات المحتملة.

  • ميزان الحرارة: يشير حقل الإعدادات إلى نوع الوحدة.
    • الوحدة:Fahrenheit
    • الوحدة:Celsius
  • SpO2:
  • PulseRate:
  • ضغط الدم:
  • WeightScale: يشير حقل الإعدادات إلى نوع الوحدة.
    • الوحدة: جنيه
    • الوحدة:كيلوغرام
  • HeightScale: يشير حقل الإعدادات إلى نوع الوحدة.
    • الوحدة:بوصة
    • الوحدة:Centimeters
  • مقياس الجلوكوز:
  • التنفس:
  • SpirometerPef:
  • SpirometerFev1:
  • SpirometerFvc:
  • مستوى الألم: يشير حقل الإعدادات إلى نوع الوحدة.
    • الوحدة:عدد
    • الوحدة:Pinad
  • حجم الخصر: يشير حقل الإعدادات إلى نوع الوحدة.
    • الوحدة:بوصة
    • الوحدة:Centimeters
  • Gttمبادرة: قراءة نسبة السكر في الدم الأولية بعد الصيام
  • Gtt1ساعة: قراءة نسبة السكر في الدم بعد ساعة واحدة
  • Gtt2ساعة: قراءة نسبة السكر في الدم بعد ساعتين
  • Gtt3ساعة: قراءة نسبة السكر في الدم بعد 3 ساعات
  • الكوليسترولHdl:
  • الكوليسترولLdl:
  • الكوليسترولالمجموع:
  • LabNotes: هذا نص عادي من حقل الملاحظة.

أنواع وسائل الإعلام

هذه هي أنواع الوسائط المتاحة جنبا إلى جنب مع أوضاعها وإعداداتها المحتملة.

  • Stethoscope: يشير حقل sensorMode إلى الوضع الذي كان فيه المستشعر أثناء القراءة. يمكن العثور على معلومات أكثر تفصيلاهنا.
    • القلب
      • الموقع:UpperLeftThorax
      • الموقع:UpperRightThorax
      • الموقع:CenterThorax
      • الموقع:LowerLeftThorax
    • الرئتان
      • الموقع:UpperMidLeftThorax
      • الموقع:UpperMidRightThorax
      • الموقع:LowerOuterLeftThorax
      • الموقع:LowerOuterRightThorax
      • الموقع:LowerSideLeftThorax
      • الموقع:LowerSideRightThorax
    • البطن
      • الموقع:UpperRightAbdomen
      • الموقع:UpperLeftAbdomen
      • الموقع:أسفل اليسارAbdomen
      • الموقع:LowerRightAbdomen
  • المنظار: يشير حقل sensorMode إلى الوضع الذي كان فيه المستشعر أثناء القراءة.
    • التنظير الجلدي
    • المنظار
  • الإيكغ
  • QTMedical

إذا كنت ترغب في مثال على كيفية عرض نتائج الامتحان ، فانقر فوق هذاعينة نتائج امتحان Htmlالرابط.

الأسئلة الشائعة
الأسئلة الشائعة

ما هي سحابة MedWand Telemedicine؟

تتكون سحابة MedWand عن بعد من الخوادم وقواعد البيانات اللازمة لتبادل البيانات بين MedWand ونظام EHR الخاص بك. كما أنه يدعم امتحان التطبيب عن بعد.

كم من الوقت يستغرق التنفيذ باستخدام واجهة برمجة تطبيقات MedWand الافتراضية عادة؟

يختلف من عميل إلى آخر بناءً على موارد المطور الخاصة بك. وقد أكمل العديد من عملائنا تنفيذ واجهة برمجة التطبيقات في أقل من بضعة أيام أو أسابيع.

ما هي بعض إعدادات الخادم المقترحة لنقطة النهاية للعودة إلى المكالمة؟

يختلف من عميل إلى آخر بناءً على الخادم وأنظمة التشغيل وأنواع / أحجام الامتحانات التي تجريها. وهنا هيوبعض الأمثلةإعدادات الخادم المقترحة.

هل يدعم MedWand تطبيقات واجهة برمجة التطبيقات المخصصة أو المستندة إلى FHIR بدلاً من JSON؟

نعم! يمكننا دعم واجهات برمجة تطبيقات FHIR المحددة للعملاء ، لكن العديد من العملاء وجدوا أن نهج واجهة برمجة تطبيقات JSON أكثر ملاءمة. سيقوم فريق مبيعات MedWand الخاص بك بإعداد اجتماع مع مهندسينا لنطاق متطلبات FHIR المحددة الخاصة بك.

هل هناك تكاليف إضافية لتطبيقات واجهة برمجة التطبيقات المخصصة أو Fhir؟

ربما! سيوفر فريق مبيعات MedWand الخاص بك توجيهات محددة و / أو مناقشات تسعير.

هل يمكن تنفيذ MedWand إذا كان لدينا تطبيق خاص بنا على الجهاز المحمول؟

نعم! قام MedWand بالعديد من التطبيقات مع العملاء باستخدام تطبيق الهاتف المحمول الخاص بهم. سيقدم فريق مبيعات MedWand توجيهات و / أو مناقشات محددة مع فريق هندسة MedWand.

ما هي بيانات PHI المخزنة بواسطة MedWand Telemedicine Cloud؟

يقوم MedWand بتخزين بضع قطع فقط من بيانات PHI لموعد قادم:

  1. أسماء الطبيب / المريض اختيارية ولكنها تسمح بتجربة مستخدم أفضل.
  2. اختياريًا ، إذا كانت هناك حاجة إلى تكامل الذكاء الاصطناعي ، فإن عمر المريض وجنسه ووزنه يسمح بوظائف الذكاء الاصطناعي أكثر دقة.

بعد أن تكون بيانات الامتحان في نظام EHR الخاص بك ، ستقوم MedWand بإزالة بيانات الامتحان وجميع PHI من أنظمتنا.

هل يمكننا فتح DoctorUrl/GuestUrl داخل iFrame؟

لا يمكننا السماح لـ DoctorUrl / GuestUrl بتضمين iFrame. وهذا من شأنه أن يضعنا في انتهاك لامتثالنا لـ SOC 2.

يمكنك فتح أي من هذه كما هو الحال في علامة التبويب الحالية أو في علامة تبويب / نافذة جديدة.

التعيينات

ما هي أنواع التعيينات المدعومة؟

نحن ندعم ثلاثة أنواع من التعيينات:

  • عن بعد: يتيح فحص الطب عن بعد للطبيب / المريض.
  • OnSite: يتيح زيارة الموقع التي لا تتطلب طبيبًا عن بعد.
  • المريض: تمكن من الفحص الذاتي من قبل المريض كما هو مطلوب أو يصفه الطبيب.

لماذا تحتاج إلى الطبيب واسم المريض؟

أسماء الطبيب / المريض اختيارية ولكنها تسمح بتجربة مستخدم أكثر تخصيصًا وودية.

لماذا تحتاج إلى عمر المريض وجنسه ووزنه؟

يسمح عمر المريض وجنسه ووزنه بوظائف الذكاء الاصطناعي الأكثر دقة. هذه المعلومات اختيارية. تكاملات الذكاء الاصطناعي مخصصة ويمكن شرحها من قبل فريق المبيعات MedWand الخاص بك.

كيف يتم إخطارنا عند الانتهاء من الموعد؟

سيقوم MedWand بإجراء مكالمة api إلى نقطة نهاية api المحددة بناءً على خيارات التكوين المحددة.

بيانات الامتحان

كيف نقوم باسترداد بيانات الامتحان لموعد مكتمل؟

يمكنك استرداد بيانات الامتحان الخاصة بك أو تلقيها بعد اكتمال الامتحان بناءً على خيارات التكوين المحددة.

ما هي التنسيقات المدعومة لتسجيل المنظار؟

نحن ندعم حاليًا بيانات base64 / mp3. إذا كانت هناك حاجة إلى معلومات إضافية عن المنظار لأنواع تكامل الذكاء الاصطناعي ، فيرجى الاتصال بفريق مبيعات MedWand.

ما هي الأشكال المدعومة لالتقاط المنظار؟

نحن ندعم حاليًا بيانات base64 / jpeg. إذا كانت هناك حاجة إلى معلومات إضافية عن الأنظار لأنواع تكامل الذكاء الاصطناعي ، فيرجى الاتصال بفريق مبيعات MedWand.

ما هي التنسيقات المدعومة لالتقاط ecg؟

نحن ندعم حاليًا بيانات base64 / jpeg. إذا كانت هناك حاجة إلى معلومات إضافية عن تخطيط كهربية الدماغ لأنواع تكامل الذكاء الاصطناعي ، فيرجى الاتصال بفريق مبيعات MedWand.



    • Related Articles

    • مرجع API V2.x

      عرض MedWand VirtualCare الافتراضي API الإصدار 2 (توثيق Swagger)

    • دليل برمجيات كشك الرعاية الافتراضية

      انقر هنا لمشاهدة دليل المستخدم

    • نظرة عامة على واجهة برمجة تطبيقات MedWand VirtualCare

      MedWand VirtualCare Examination Platform تم تصميم منصة امتحان MedWand VirtualCare للعمل كوحدة إضافية لبرامج PMS / HIS / EHR الحالية ، والمعروفة أيضًا باسم. برنامج المؤسسة. تقع على عاتق برنامج المؤسسة مسؤولية مصادقة جميع المستخدمين ، وإنشاء مواعيد بين ...

    • خدمات المطورين MedWand

      تقوم MedWand بتطوير وتقديم العديد من المنتجات والخدمات المستندة إلى السحابة التي تسهل وتدعم مؤتمرات Telemedicine عبر تقنية منصة VirtualCare وجناح مطوري الأجهزة MedWand. كما تقدم MedWand خدمات احترافية تتعلق بهذه المنتجات. ستخضع اتفاقية مع MedWand ، ...

    • MedWand Device المواصفات التقنية

      تقنية جهاز MedWandالمواصفات العامة: المقصودمن أجلالاستخدامعلىوبواسطةالبالغين(18yrs)أوكبار السن) غير السامة للخلايامن أجلالكلالمرضىوالمستخدمالاتصاللكلIso10993-5. غير مزعجوغير حساسيةمن أجلالكلالمريضوالمستخدمالاتصاللكلIso10993-10. ...