> ## 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.

# بدء سريع

> صك وتحقق من سجل باستخدام جهة إصدار مساحة العمل ومفتاح التوقيع الخاص بك.

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

## قبل أن تبدأ

في [Console](https://console.truthlocks.com)، حدد مساحة العمل والبيئة الخاصة بك. احصل على مفتاح 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 إلى الإنتاج.

```python theme={null}
import base64
import json
import os
import urllib.request
import uuid

base_url = os.environ.get("TRUTHLOCKS_BASE_URL", "https://sandbox-api.truthlocks.com").rstrip("/")
payload = json.dumps({"subject": "demo-record", "message": "Example issuer claim"},
                     separators=(",", ":")).encode("utf-8")
body = {
    "issuer_id": os.environ["TRUTHLOCKS_ISSUER_ID"],
    "kid": os.environ["TRUTHLOCKS_KEY_ID"],
    "alg": os.environ["TRUTHLOCKS_ALGORITHM"],
    "content_type": "application/json",
    "payload_b64url": base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
}
# Retain this value and the same body if retrying this mint request.
idempotency_key = str(uuid.uuid4())
request = urllib.request.Request(
    base_url + "/v1/attestations/mint",
    data=json.dumps(body).encode("utf-8"),
    headers={"Content-Type": "application/json",
             "X-API-Key": os.environ["TRUTHLOCKS_API_KEY"],
             "Idempotency-Key": idempotency_key},
    method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
    record = json.load(response)
print("Attestation ID:", record["attestation_id"])
print("Recorded at (Unix seconds):", record["issued_at_unix"])
```

تثير أخطاء HTTP `urllib.error.HTTPError`. تعامل مع الأخطاء والمهل الزمنية في تطبيقك؛ حافظ على نفس مفتاح الثبات والنص عند إعادة محاولة نتيجة صك غير مؤكدة.

تستخدم الاستجابة `attestation_id` و`issued_at_unix` و`signature` و`log`. لا تعكس المطالبات كـ `payload` على المستوى الأعلى. احتفظ بالبايتات الأصلية لإجراء فحوصات التكامل اللاحقة.

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

استخدم [مرجع التحقق](https://docs.truthlocks.com/ar/api-reference/verify.md) مع `attestation_id` الذي تم إرجاعه. قم بتوفير `payload_b64url` للتحقق من البايتات الأصلية الدقيقة، أو `document_hash_hex` لمقارنة تجزئة الملف. افحص `verdict` و `reasons`: لا يعني استجابة HTTP الناجحة وحدها أن السجل صالح.

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

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

تابع باستخدام [معلمات السك](https://docs.truthlocks.com/ar/api-reference/attestations/mint.md)، و[المصادقة](https://docs.truthlocks.com/ar/security/auth.md)، و[البيئات](https://docs.truthlocks.com/ar/environments.md).


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