1. المصادقة
يجب أن تتم مصادقة جميع طلبات API عبر رموز Bearer.- مفاتيح API: تصدر عبر Console للمستأجر (الأمان > مفاتيح API).
- النطاقات: يتم تحديد نطاق المفاتيح لإجراءات محددة (مثل
mint،verify،read_audit). - الدوران: نوصي بسياسة دوران مدتها 90 يومًا. قم بإلغاء صلاحية المفاتيح فورًا عبر نقطة نهاية DELETE عند الاختراق.
2. تدفق السك
لإصدار شهادة، أرسل حمولة JSON إلى/v1/attestations/mint.
3. Webhooks والأحداث
تستخدم Truthlocks خطافات الويب (webhooks) لإخطار نظامك بتغيرات الحالة.
التحقق: تحقق دائمًا من رأس
X-Truthlocks-Signature باستخدام السر المشترك لنقطة النهاية الخاصة بك. راجع دليل الويب هوكس للحصول على تفاصيل كاملة حول أنواع الأحداث، والتحقق من التوقيع، وسلوك إعادة المحاولة.
4. حزم الإثبات
حزمة الإثبات هي كائن JSON موقّع يحتوي على:- البيانات الأصلية: الحمولة التي قمت بإنشائها.
- توقيع المُصدر: دليلك التشفيري على النية.
- نقطة تفتيش المنصة: إثبات Truthlocks لحالة الشبكة وقت السك.
5. حدود المعدل والحصص
تُطبق الحدود لكل مستأجر بناءً على مستوى اشتراكك:- الاندفاع العالمي: 500 طلب لكل 10 ثوانٍ.
- حصة السك الشهرية: محددة في اتفاقية المؤسسة الخاصة بك (يمكن عرضها في
/v1/billing/usage).
6. فصل البيئة
نحن نقدم بيئتين متميزتين:- صندوق الرمل (
sandbox.truthlocks.com): للاختبار باستخدام مفاتيح وهمية وبيانات مؤقتة. - الإنتاج (
api.truthlocks.com): موحد لإصدارات عالية المخاطر.

