Skip to main content
تقرأ واجهة البرمجة المستندات (extract) وتتحقق من ملف العميل (verify)، وهما من المهام التي تؤديها Sahl للمقرضين والبنوك. أما الربط البنكي وحساب النقاط فيتمان من وحدة التحكم. هذا هو التدفق الفعلي في الإصدار v0.2.0. لمثال أطول انظر الشرح التطبيقي، ولتجربة الاستدعاءات دون كتابة شيفرة انظر الاختبار في بيئة الاختبار.

قبل البدء

  1. فعّل واجهة الشركاء البرمجية في مساحة العمل الخاصة بك. تُفعَّل لكل مساحة عمل من قِبل Sahl ولا يمكن تفعيلها ذاتيًا: اطلب الوصول إلى بيئة الاختبار.
  2. في وحدة التحكم افتح Settings، ثم API Keys، ثم New key. حدّد kyc:extract وkyc:verify. انسخ السر مرة واحدة. احتفظ به على خادمك.
عيّنه في المتغير SAHL_API_KEY. تستخدم جميع الأمثلة https://app.sahlfinancial.com/api وenvironment=sandbox وبيانات وهمية. استخدم صورة وهمية خاصة بك لبطاقة التعريف الوطنية المغربية (CIN).

1. قراءة مستند

أرسل من 1 إلى 5 ملفات (JPEG أو PNG أو WebP أو TIFF أو PDF، بحد أقصى 30 MB لكل ملف). أضف reference (معرّفك الخاص للعميل) لحفظ النتيجة في ملف قضية.
تتضمن الاستجابة fields وdocuments وfield_count وchecks وreader_unavailable وpolicy. وعند وجود reference تتضمن أيضًا case_id وdocument_ids. انظر قراءة المستندات.

2. التحقق من الملف

أعد إرسال عناصر documents كما وردت، مع الحقول التي تملكها.

3. قراءة الحكم

تكون قيمة passed صحيحة (true) عندما لا يفشل أي فحص حرج. وتسرد critical_failures وflags ما يحتاج إلى مراجعة شخص. الملف الذي لا تتضمن مستنداته هوية بصورة يفشل بالمعرّف required:photo_id، لذا أرسل العناصر الناتجة من الخطوة 1. ويقبل /v1/kyc/assess الجسم نفسه ويضيف تقييم المخاطر. بفضل reference تُحفظ القضية ومستنداتها والحكم في مساحة عملك، حيث يراها موظفوك ضمن Cases وDocuments.

التالي

التحقق من ملف

كل فحص، وما يعيده، وكيفية قراءة passed وflags.

الأخطاء

كل حالة وكل رمز، مع الحل.