الانتقال إلى المحتوى الرئيسي
يوقع الإشهاد حمولة ويسجل تجزئتها. يتحقق التحقق من السلامة التشفيرية وحالة السجل؛ ولا يثبت بشكل مستقل أن ادعاءات المصدر صحيحة.

قبل أن تبدأ

في Console، حدد مساحة العمل والبيئة الخاصة بك. احصل على مفتاح API، ومعرف المصدر، ومفتاح نشط متاح للتوقيع من جانب الخادم. استخدم الخوارزمية الموضحة لهذا المفتاح. تسجيل مفتاح عام وحده لا يمنح خدمة التوقيع مفتاحها الخاص. استخدم https://sandbox-api.truthlocks.com بمفتاح sandbox (tl_test_). استخدم https://api.truthlocks.com بمفتاح إنتاج (tl_live_) ومساحة عمل معتمدة. يجب أن تنتمي الموارد وبيانات الاعتماد إلى نفس البيئة. لا ترسل X-Tenant-ID لاختيار مساحة عمل: يتم اشتقاقها من بيانات الاعتماد الخاصة بك.

سك سجل

يستخدم هذا المثال مكتبة Python 3 القياسية. قم بتعيين متغيرات البيئة الأربعة المطلوبة من خلال shell أو مدير الأسرار الخاص بك. قم بتعيين TRUTHLOCKS_BASE_URL فقط إذا كنت تنتقل من sandbox إلى الإنتاج.
تثير أخطاء HTTP urllib.error.HTTPError. تعامل مع الأخطاء والمهل الزمنية في تطبيقك؛ حافظ على نفس مفتاح الثبات والنص عند إعادة محاولة نتيجة صك غير مؤكدة. تستخدم الاستجابة attestation_id وissued_at_unix وsignature وlog. لا تعكس المطالبات كـ payload على المستوى الأعلى. احتفظ بالبايتات الأصلية لإجراء فحوصات التكامل اللاحقة.

التحقق من النتيجة

استخدم مرجع التحقق مع attestation_id الذي تم إرجاعه. قم بتوفير payload_b64url للتحقق من البايتات الأصلية الدقيقة، أو document_hash_hex لمقارنة تجزئة الملف. افحص verdict و reasons: لا يعني استجابة HTTP الناجحة وحدها أن السجل صالح.

استكشاف الأخطاء وإصلاحها

  • 401 أو 403: تحقق من بيانات الاعتماد، والبيئة، والأذونات، وموافقة مساحة العمل.
  • 400: تحقق من UUIDs، ورأس عدم التكرار، وتشفير base64url غير المحشو.
  • خطأ في المفتاح أو السياسة: تأكد من أن المصدر والمفتاح قابلان للاستخدام للتوقيع وأن الخوارزمية متطابقة.
  • مهلة: أعد المحاولة باستخدام النص الأصلي ومفتاح عدم التكرار، بدلاً من إنشاء صك جديد.
تابع باستخدام معلمات السك، والمصادقة، والبيئات.