الانتقال إلى المحتوى الرئيسي
GET
الحصول على التحقق من المستندات
يعرض الحالة الحالية ونتائج التحقق لمستند تم تقديمه مسبقًا. عند اكتمال المعالجة، يتضمن الرد حكم الذكاء الاصطناعي و (إذا كان ذلك ممكنًا) حكم الإنسان، بالإضافة إلى المطالبة بالحقيقة ومعرفات الإيصال المرتبطة.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

string
معرف سجل التحقق من المستند.
string
الوكيل الذي قدم المستند.
string
تصنيف المستند.
string
اسم الملف الأصلي.
string
ملخص SHA-256 السداسي عشري لمحتوى المستند.
string
حالة المعالجة الحالية. أحد الخيارات: - processing — يتم معالجة المستند تم تحليلها - verified — تم اجتياز المستند للتحقق - disputed — المستند لديه إشارات متضاربة - rejected — فشل المستند في التحقق (تم اكتشاف تلاعب أو تزوير أو عدم صلاحية)
string
تحديد نموذج الذكاء الاصطناعي. أحد الخيارات التالية: authentic، suspicious، forged، inconclusive. null أثناء المعالجة.
number
ثقة نموذج الذكاء الاصطناعي في حكمه كعدد عشري بين 0.0 و 1.0. null أثناء المعالجة.
string
تحديد المراجع البشري، إذا تم تشغيل المراجعة البشرية. أحد الخيارات التالية: authentic، suspicious، forged، inconclusive. null إذا لم يكن بعد تمت مراجعته أو لم تكن المراجعة البشرية مطلوبة.
string
معرف ادعاء الحقيقة الذي تم إنشاؤه تلقائيًا لهذا المستند التحقق. التنسيق: maip-tc:ULID.
string[]
قائمة معرفات الإيصالات التي تم سكها أثناء عملية التحقق. عادةً يتضمن إيصال التحقق، وإذا كان ذلك ممكنًا، مراجعة بشرية الإيصال.
string
طابع زمني ISO 8601 لتاريخ تقديم المستند.
string
طابع زمني ISO 8601 لآخر تغيير في الحالة.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

معلمات المسار

documentId
string<uuid>
مطلوب

معرف التحقق من المستند

الاستجابة

تفاصيل التحقق من المستند

verification_id
string<uuid>
document_id
string<uuid>
document_hash
string
status
enum<string>
الخيارات المتاحة:
pending,
verified,
failed
results
object[]
verifications
object[]
claims
object[]
created_at
string<date-time>