الانتقال إلى المحتوى الرئيسي
POST
التحقق من التصديق
تحقق من الحالة الحالية للسجل والأدلة المتاحة. للتحقق من توقيعه التشفيري، أرسل الحمولة الأصلية الموقعة بالضبط كـ payload_b64url. لا يمكن لمعرف السجل أو بصمة الملف وحدها توفير تلك البايتات.

اختر الفحص الذي تحتاجه

يعيد فحص المعرف فقط أو البصمة فقط INCOMPLETE و signature_verified: false ما لم تنطبق نتيجة أقوى مثل REVOKED أو EXPIRED أو ALTERED. قم بتوفير الحمولة الأصلية لإجراء فحص توقيع كامل. يجب أن تحدد attestation المضمنة سجلًا مسجلًا باستخدام attestation_id. يتم تحميل الحالة عبر الإنترنت وهوية المفتاح من هذا السجل؛ لا يمكن للحقول المقدمة من المتصل تجاوز مصدرها أو إلغائها. استخدم مدققًا غير متصل متوافقًا لإجراء فحوصات التوقيع المستقلة.

تفسير الاستجابة

signature_verified يبلغ عن فحص التوقيع على وجه التحديد. log.proof_checked يبلغ عن التحقق الناجح من تضمين الشفافية. ينتج عن الإثبات المفقود سبب وفهرس ورقة فارغ؛ الصفر هو ورقة أولى مشروعة. لا يعني عدم وجود قيمة expires_at_unix أنه يجب اختراع تاريخ انتهاء صلاحية جديد لسجل تاريخي.
لا يثبت التوقيع الصالح الملكية أو الصلاحية القانونية أو صحة كل ادعاء. اقرأ reasons، وحوكمة المصدر الحالية، والأدلة المتاحة قبل الاعتماد على سجل. قد تكون فحوصات السياسة أو السجل الاختيارية غير متاحة حتى عندما ينجح توقيع الحمولة.

المصادقة والقيود

لا يتطلب التحقق العام مفتاح API. تستخدم المكالمات الموثقة مساحة عمل المتصل وبيئته وقد تخضع لبدل التحقق الخاص بها. لا تزال حدود معدل الخدمة تنطبق على الطلبات العامة. قد لا يكون السجل الخاص أو التجريبي متاحًا من خلال بحث إنتاجي مجهول. شارك سجلًا يمكن الوصول إليه باستخدام https://verify.truthlocks.com/proof/{attestation_id}. لا يمنح عنوان URL المشترك الوصول إلى الحمولات الخاصة.

التفويضات

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

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

الجسم

application/json
attestation
object | null

مغلف البحث عبر الإنترنت. مطلوب معرف attestation_id مسجل هنا أو على مستوى الطلب. الحالة المخزنة، والمصدر، والمفتاح، ووقت الإصدار هي سلطة؛ لا يمكن للنسخ المقدمة تجاوزها.

attestation_id
string
document_hash_hex
string
payload_b64url
string

الاستجابة

200 - application/json

نتيجة التحقق

أدلة التحقق العامة. افحص الأسباب والفحوصات الفردية؛ لا يتحقق الفحص الذي يعتمد على المعرف فقط من المحتوى الأصلي الذي قدمه المتصل.

verdict
enum<string>
مطلوب

افحص الأسباب، ومدخلات التحقق المقدمة، و log.proof_checked جنبًا إلى جنب مع هذا الحكم. VALID وحده لا يثبت الملكية أو يثبت كل مطالبة في السجل.

الخيارات المتاحة:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

صحيح فقط عندما تكون الحمولة الأصلية المقدمة قد اجتازت التحقق من التوقيع التشفيري. تعيد عمليات التحقق من المعرف فقط وبصمة الإصبع فقط قيمة خاطئة.

reasons
string[]
attestation_id
string<uuid>
issuer_id
string<uuid>
expires_at_unix
integer<int64> | null

تاريخ انتهاء الصلاحية الموقع المسجل بثواني يونكس؛ يعني null عدم تسجيل تاريخ انتهاء صلاحية. لا يتم تعيين تاريخ انتهاء صلاحية جديد للسجلات القديمة.

issued_at_unix
integer<int64>

وقت الإصدار المخزن الأصلي بالثواني Unix. هذا ليس وقت الفحص الحالي أو تنزيل الشهادة. غائب إذا كان غير متاح.

kid
string

معرف مفتاح التوقيع.

alg
string

خوارزمية التوقيع المعلنة.

payload_hash
string

ملخص SHA-256 المشفر بـ Base64url للحمولة القانونية.

document_hash
string

بصمة SHA-256 السداسية عشرية للملف الأصلي، عند تخزينه.

log
object
governance
object