reference.
/extract وحده يستدعي نموذج الرؤية، لذا فهو الوحيد الذي يُحتسب استهلاكه. ويُفحص الرصيد المسموح قبل قراءة أي ملف.
المسار الرئيسي
ما تمرّره من استدعاء إلى آخر:
يأخذ
/assess الجسم نفسه الذي يأخذه /verify ويجري التحقق نفسه أولاً. إذا أردت الإجابتين معاً، فاستدعِ /assess فقط: يحتوي مفتاح verification فيه على الحكم الكامل.
لماذا تُعاد العناصر
لا يقرأ/verify الملفات. بل يفحص عناصر documents[] التي ترسلها، لذا يحتاج إلى ما رآه /extract: نوع الوثيقة والحقول وتواريخ الملف وstep_key. فبدون step_key قد تجتاز الوثيقة نفسها فحص النوع في /extract وتخفق فيه في /verify. ولهذا السبب تضع الواجهة step_key على كل عنصر.
إذا عدّلت عنصراً، فإنك تتحقق من تعديلك لا من الوثيقة.
مسار eID
لا يوجد استدعاء راجع من المزوّد. أنت تستطلع، وترسل Sahl webhookkyc.eid_completed عند أول استطلاع يرى حالة الانتهاء. التفاصيل في التحقق عبر eID. في هذا الإصدار تقتصر خاصية eID على العملاء الكنديين، لذا يستخدم الطلب النموذجي country=CA؛ أما كل استدعاء آخر في هذه الصفحة فيقبل أي بلد، مثل MA.
دورة حياة الحالة
توجد الحالة مرة واحدة لكل مساحة عمل وبيئة وreference. وكل استدعاء بهذا المرجع يحدّثها.
لا تُلغي إعادة التحقق أبداً حالةً حددها شخص: تبقى approved وrefused.
اختيار الاستدعاءات
لا تتضمن الواجهة مفتاح idempotency ولا نقطة نهاية للدفعات. فإرسال الاستدعاء نفسه مرتين يقرأ الملفات مرتين ويحتسب قراءتين، ويحفظ مجموعة وثائق ثانية في الحالة. راجع الأخطاء وإعادة المحاولة.