REST API وWebhooks: نظام الزوار كجزء من منظومتك التقنية
عندما تحتاج بوابة المواعيد أو تطبيق الموظفين أو نظام المشتريات إنشاء زيارة أو معرفة حالتها، يوفر النظام واجهات برمجية موثقة وأحداثًا لحظية.
REST APIsWebhooksطبقة تكامل
أمثلة على العمليات المتاحة
أمثلة توضيحية للعمليات؛ يُسلَّم التوثيق الكامل للواجهات ضمن المشروع.
| العملية | الوصف |
|---|---|
| POST /visits | إنشاء زيارة بنفس قواعد الحقول والموافقات |
| GET /visits/{id} | حالة الزيارة وموافقاتها |
| POST /visits/{id}/cancel | إلغاء زيارة وسحب رمزها |
| GET /onsite | الموجودون الآن حسب الموقع |
| GET /contractors/{id}/permits | تصاريح عامل مقاول |
أحداث Webhooks
| الحدث | متى يُرسل |
|---|---|
| visit.approved | اكتمال الموافقات |
| visitor.checked_in | تسجيل الوصول |
| visitor.checked_out | تسجيل المغادرة |
| visit.overstayed | تجاوز المدة |
| document.expiring | قرب انتهاء وثيقة |
طبقة التكامل Integration Layer
للأنظمة التي لا تتعامل مع REST أو Webhooks، تُبنى طبقة تكامل تحول البيانات بين الصيغ، أو تتبادل الملفات بشكل مجدول.
- مصادقة بمفاتيح وصلاحيات محددة
- سجل لكل طلب برمجي
- حدود استخدام لحماية النظام
مثال تكامل: بوابة المواعيد الحكومية
المراجع يحجز موعدًا في بوابة الجهة.
بوابة المواعيد تنشئ الزيارة في نظام الزوار.
يعود الحدث لبوابة المواعيد لإرسال الرمز للمراجع.
عند الوصول يُحدّث حالة الموعد في بوابة المواعيد.
للمطورين
بيئة اختبار
للتطوير قبل الربط بالإنتاج.
مفاتيح منفصلة
لكل نظام مرتبط بصلاحياته.
صيغة JSON
للطلبات والردود والأحداث.
أسئلة شائعة عن REST API وWebhooks
نقدم ملخص الواجهات في مرحلة التقييم، والتوثيق الكامل ضمن المشروع.
نعم، لكل مفتاح نطاق وصلاحيات محددة.
نعم، مع سجل بمحاولات الإرسال.
فريقك التقني يريد التفاصيل؟
نرتب جلسة فنية مع فريق التطوير.