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

# Go SDK

يحتوي المصدر على حزمة `truthlock` جذرية وعميل `pkg` قديم. إنهما واجهتان مختلفتان؛ لا تخلط بين أسماء الطرق أو أنواع الطلبات من أحدهما مع الآخر.

مسار الوحدة الجذر هو:

```text theme={null}
github.com/truthlocks/sdk-go
```

ثبّت الوحدة العامة المصححة باستخدام `go get github.com/truthlocks/sdk-go@v0.4.0`. استخدمت العلامات القديمة مسار وحدة غير متوافق.

## تهيئة العميل

```go theme={null}
client := truthlock.NewClient(truthlock.Config{
    BaseURL: "https://sandbox-api.truthlocks.com",
    APIKey: os.Getenv("TRUTHLOCKS_API_KEY"),
})
```

هذا جزء لبرنامج Go يستورد الوحدة، `os`، و `context`. استخدم مفتاحًا يطابق المضيف. معرف المستأجر وحده ليس مصادقة؛ يستمد الخادم مساحة العمل من بيانات الاعتماد.

## سك العملة

يقبل العميل الجذر `MintRequest` مع `IssuerID` و`KID` و`Alg` و`PayloadB64URL`. قم بترميز البايتات الأصلية باستخدام `base64.RawURLEncoding.EncodeToString`. بدلاً من ذلك، قم بتعيين `Schema` و`Claims` واترك `PayloadB64URL` فارغًا لاستخدام إدخال منظم. لا تجمع بين وضعي الإدخال.

```go theme={null}
record, err := client.Attestations.Mint(ctx, &truthlock.MintRequest{
    IssuerID: os.Getenv("TRUTHLOCKS_ISSUER_ID"),
    KID: os.Getenv("TRUTHLOCKS_KEY_ID"),
    Alg: truthlock.Algorithm(os.Getenv("TRUTHLOCKS_ALGORITHM")),
    PayloadB64URL: base64.RawURLEncoding.EncodeToString([]byte(`{"subject":"demo-record"}`)),
})
if err != nil { return err }
fmt.Println(record.AttestationID)
```

ينتمي هذا الجزء إلى دالة تُرجع `error`؛ قم باستيراد `encoding/base64` و `fmt`، وقدم `ctx`. استخدم جهة إصدار ومفتاح توقيع تم توفيرهما بالفعل للبيئة.

## عقود الطلب والاستجابة

يقوم النقل الجذري المصحح بإجراء طلبات HTTP ويعرض أخطاء HTTP و JSON. احتوت لقطات المصدر السابقة على نقل لا يعمل؛ لا تعامل العودة الناجحة من هذا الإصدار كدليل على أن الطلب وصل إلى Truthlocks. تحقق من إصدار المصدر المثبت الخاص بك.

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

استخدم [مرجع واجهة برمجة التطبيقات](https://docs.truthlocks.com/ar/api-reference/attestations/mint.md) لحقول الأسلاك و [البدء السريع لـ HTTP المباشر](https://docs.truthlocks.com/ar/quickstart.md) عند التحقق من سلوك إصدار الحزمة.


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