نظرة عامة
يوثّق هذا القسم عقد API (المعروف داخلياً بـ TCA / Check.Integration)، الذي يُستخدم عندما تمتلك تطبيقات العميل خطوة الالتقاط وترسل الصورة مباشرةً إلى المنصة.
متى تستخدم هذا العقد
استخدم عقد API عندما:
- قام تطبيقك بالتقاط السيلفي أو الصورة بالفعل (عبر SDK الأصلي لـ Unico أو حزمة خاصة — معيار الالتقاط).
- تريد نتائج متزامنة في استجابة إنشاء العملية ذاتها.
- لا تريد توجيه المستخدم إلى رحلة مستضافة.
- تفضل بنيتك مكالمات خادم إلى خادم التقليدية (طلب ← استجابة بالنتيجة).
إذا أردت من Unico استضافة الرحلة، استخدم Web & SDK بدلاً من ذلك.
مرجع API
استرداد المستندات القابلة لإعادة الاستخدام
التحقق مما إذا كان المستخدم لديه بالفعل مستند قابل لإعادة الاستخدام قبل بدء تدفق التقاط جديد.
إنشاء عملية مستند
التقاط مستند جديد أو إعادة استخدام مستند ملتقط مسبقاً مرتبط بعملية بيومترية.
التحقق من البيانات
الاستعلام عن بيانات التسجيل وفحص الأشخاص المعرّضين سياسياً/غسيل الأموال والعلاقة الرياضية لرقم CPF معين.
تكامل العميل
معيار الالتقاط
المتطلبات التقنية التي يجب أن يستوفيها الالتقاط الخاص بك عند عدم استخدام SDK لـ Unico — الدقة والتنسيق والإضاءة والمزيد.
الفروق عن Web & SDK
| الجانب | API | Web & SDK |
|---|---|---|
| وقت إنشاء العملية | بعد الالتقاط | قبل الالتقاط |
| إعادة الصورة | فورية (بعد الالتقاط من جانب العميل) | عبر نقطة نهاية مخصصة |
| التحكم في الرحلة | العميل | Unico |
| التحكم في الالتقاط | العميل (بأو بدون SDK) | Unico |
| التعريف | subject.code | person.duiType + person.duiValue |
| الرؤوس | Authorization + APIKEY | Authorization فقط |
| مخطط النتيجة | مسطح (unicoId.result، liveness، إلخ.) | متداخل (process.authenticationInfo.*Result) |
الخطوات التالية
- إنشاء عملية — عقد الإعداد الكامل.
- رموز الخطأ — التعامل مع استجابات 4xx و5xx.