> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# حزمة التكامل التقني

> دليل البدء السريع للمطور واستراتيجية API

**دليل البدء السريع للمطورين واستراتيجية واجهة برمجة التطبيقات (API)**

## 1. المصادقة

يجب أن تتم مصادقة جميع طلبات API عبر رموز Bearer.

* **مفاتيح API**: تصدر عبر Console للمستأجر (الأمان > مفاتيح API).
* **النطاقات**: يتم تحديد نطاق المفاتيح لإجراءات محددة (مثل `mint`، `verify`، `read_audit`).
* **الدوران**: نوصي بسياسة دوران مدتها 90 يومًا. قم بإلغاء صلاحية المفاتيح فورًا عبر نقطة نهاية DELETE عند الاختراق.

## 2. تدفق السك

لإصدار شهادة، أرسل حمولة JSON إلى `/v1/attestations/mint`.

```json theme={null}
{
  "template_key": "academic_transcript",
  "payload": {
    "student_id": "STU123",
    "gpa": "3.8"
  },
  "recipient_email": "student@university.edu"
}
```

## 3. Webhooks والأحداث

تستخدم Truthlocks خطافات الويب (webhooks) لإخطار نظامك بتغيرات الحالة.

| نوع الحدث | الوصف |
| :- | :- |
| `attestation.created` | يتم تشغيله عندما تقوم المنصة بتوقيع السجل. |
| `issuer.suspended` | يتم تشغيله إذا تغير تقييم ثقة المُصدر. |
| `billing.usage.threshold` | يتم تشغيله عند الوصول إلى حد الاستخدام. |

**التحقق**: تحقق دائمًا من رأس `X-Truthlocks-Signature` باستخدام السر المشترك لنقطة النهاية الخاصة بك. راجع [دليل الويب هوكس](https://docs.truthlocks.com/ar/guides/webhooks.md) للحصول على تفاصيل كاملة حول أنواع الأحداث، والتحقق من التوقيع، وسلوك إعادة المحاولة.

## 4. حزم الإثبات

حزمة الإثبات هي كائن JSON موقّع يحتوي على:

1. **البيانات الأصلية**: الحمولة التي قمت بإنشائها.
2. **توقيع المُصدر**: دليلك التشفيري على النية.
3. **نقطة تفتيش المنصة**: إثبات Truthlocks لحالة الشبكة وقت السك.

## 5. حدود المعدل والحصص

تُطبق الحدود لكل مستأجر بناءً على مستوى اشتراكك:

* **الاندفاع العالمي**: 500 طلب لكل 10 ثوانٍ.
* **حصة السك الشهرية**: محددة في اتفاقية المؤسسة الخاصة بك (يمكن عرضها في `/v1/billing/usage`).

***

## 6. فصل البيئة

نحن نقدم بيئتين متميزتين:

* **صندوق الرمل (`sandbox.truthlocks.com`)**: للاختبار باستخدام مفاتيح وهمية وبيانات مؤقتة.
* **الإنتاج (`api.truthlocks.com`)**: موحد لإصدارات عالية المخاطر.

> [!TIP]
>
> استخدم [SDKs](https://docs.truthlocks.com/ar/sdk/js.md) الخاص بنا للتعامل مع عمليات إعادة المحاولة، والتحقق من التوقيع، و
> تسلسل الحمولة تلقائيًا.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.