الاتصال عبر واجهة REST API

تتيح لك واجهة USystems REST API دمج بيانات المرضى والفوترة والمستخدمين مع أدواتك وسير عملك الخاص. يتم إرسال كل طلب عبر HTTPS إلى عنوان URL أساسي خاص بكل مستأجر بالصيغة https://api.usystems.io/v1/{tenant-id}/.

تستخدم المصادقة رمز حامل (bearer token). يجب أن يتضمن كل طلب ترويسة Authorization بالصيغة Authorization: Bearer YOUR_API_KEY. يمكنك إنشاء مفتاح من Settings > Developer، كما هو موضح في مقالة منفصلة.

إليك مثالاً بسيطًا لجلب سجل مريض واحد باستخدام المعرّف:

curl https://api.usystems.io/v1/{tenant-id}/patients/12345
-H "Authorization: Bearer YOUR_API_KEY"

يُرجع الطلب الناجح كائن JSON يحتوي على الحقول الديموغرافية للمريض ومعرّفات السجل وروابط إلى موارد ذات صلة مثل المواعيد والفواتير. تُطبَّق حدود المعدل لكل مفتاح API، وتظهر الحدود الحالية دائمًا في ترويسات الاستجابة بحيث يمكن لتكاملك التباطؤ بسلاسة عند الحاجة. تتوفر الوثائق الكاملة لنقاط النهاية، بما في ذلك عمليات الكتابة، عبر بوابة المطورين المرتبطة ضمن Settings > Developer.