إعداد الويب هوك (Webhooks)

تتيح الويب هوك للأنظمة الخارجية الاستجابة فورًا عند حدوث أي تغيير داخل USystems Atlas، بدلًا من الاستعلام المتكرر عن واجهة برمجة التطبيقات. تقوم بتسجيل عنوان HTTPS واحد فقط، ويقوم Atlas بإرسال حمولة الحدث إليه فور وقوع الإجراء المطابق.

للبدء، افتح Settings > Integrations > Webhooks وانقر على Add Endpoint. الصق عنوان HTTPS يمكن الوصول إليه علنًا، واختر الأحداث التي تهمك، مثل patient.created وpatient.updated وinvoice.paid وuser.deactivated. يمكنك الاشتراك في أي عدد تحتاجه من أنواع الأحداث على نقطة نهاية واحدة، أو توزيعها عبر عدة نقاط نهاية.

يتضمن كل طلب ويب هوك رأس X-Atlas-Signature، وهو تجزئة (hash) للحمولة يتم توليدها باستخدام مفتاح التوقيع الظاهر في صفحة تفاصيل نقطة النهاية. يجب أن يعيد خادمك المستقبل حساب هذه التجزئة ويرفض أي طلب لا تتطابق توقيعاته، ما يحميك من الطلبات المزيفة.

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