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

# حزمة تطوير برامج Python

ثبّت التوزيع الذي تكون حزمة مصدره `truthlock`:

```bash theme={null}
python -m pip install "truthlock>=0.4.0"
```

الاستيراد هو `from truthlock import TruthlockClient`. أسماء الحزم لتكاملات MAIP هي توزيعات منفصلة ولا تعني نفس واجهة برمجة التطبيقات.

## سك العملة باستخدام مفتاح توقيع موجود

```python theme={null}
import base64
import json
import os
from truthlock import TruthlockClient

payload = json.dumps({"subject": "demo-record"}, separators=(",", ":")).encode("utf-8")
with TruthlockClient(
    api_key=os.environ["TRUTHLOCKS_API_KEY"],
    base_url="https://sandbox-api.truthlocks.com",
) as client:
    record = client.attestations.mint(
        issuer_id=os.environ["TRUTHLOCKS_ISSUER_ID"],
        kid=os.environ["TRUTHLOCKS_KEY_ID"],
        alg=os.environ["TRUTHLOCKS_ALGORITHM"],
        payload_b64url=base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
    )
    print(record.attestation_id)
```

عيّن متغيرات البيئة الأربعة أولاً. استخدم مفتاحًا، ومصدرًا، ومفتاحًا متاحًا للتوقيع في تلك البيئة. لا يوفر تسجيل المفتاح العام مفتاح توقيع خاص.

## تحقق

استدعِ `client.verify.verify_online(attestation_id=record.attestation_id)` وافحص الحكم. أضف `payload_b64url` عند التحقق من البايتات الأصلية. يستخدم الواجهة الخلفية أحكامًا علوية؛ يقوم SDK المصحح بتطبيعها إلى قيم التعداد الصغيرة الخاصة به. يتضمن الإصدار 0.4.0 والإصدارات الأحدث تحليل الحكم المصحح.

## حدود الإصدار وإعادة المحاولة

مجموعات الموارد الأساسية المنفذة هي `issuers`، `keys`، `attestations`، `verify`، و `receipts`. لا تستدعِ طرق الموارد الافتراضية `consumer`، `governance`، أو `audit` على هذا العميل.

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

استخدم [البدء السريع لـ HTTP](https://docs.truthlocks.com/ar/quickstart.md) لمقارنة إصدار مع العقد الفعلي. قم بتثبيت الإصدار 0.4.0 أو أحدث لاستخدام حقول النقل وحزمة الإثبات المصححة.


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