استراتيجية الاحتياطي
في حالة أي عدم توفر في خدمة webhook، يُوصى بتطبيق آلية احتياطية لضمان قدرة تطبيقك على استرداد نتيجة العملية ضمن وقت الاستجابة المتوقع.
كيف يعمل
webhook هو آلية التسليم الأساسية للنتائج. ومع ذلك، يجب معاملة الإشارات التالية كمحفزات إضافية للحصول على النتيجة بنشاط عبر GET /client/v1/process/{processId}:
| الإشارة | القناة | ما تُوفره |
|---|---|---|
استدعاء onFinish | SDK Web / WebMobile | إشارة نهاية الرحلة — بدون نتيجة |
إعادة توجيه callbackUri | جميع القنوات الأخرى | إعادة توجيه URL فحسب — بدون نتيجة |
تحذير
لا تُسلّم onFinish ولا callbackUri نتيجة العملية مباشرةً. هما إشارتا نهاية رحلة فحسب. الخادم الخلفي الخاص بك مسؤول عن ربط id المستلم (أو إعادة التوجيه) بـprocessId المخزَّن مسبقاً، ثم استدعاء GetProcess لاسترداد النتيجة الفعلية.
التدفق الموصى به
بمجرد تلقي إشارة نهاية الرحلة، يجب على الخادم الخلفي الخاص بك استدعاء GET /client/v1/process/{processId} والتحقق من النتيجة بالترتيب التالي:
- تأكد من أن
state = PROCESS_STATE_FINISHED - قيّم حقل
resultوطبّق قواعد عملك
يضمن هذا عدم تسبب عدم توفر webhook المؤقت في فقدان نتائج العملية.