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

# أمثلة التكامل

> مثال على سك HTTP مباشر مع ترميز صريح وتكرارية.

يستخدم هذا المثال `fetch` المدمج في Node.js لجعل عقد HTTP صريحًا. لا يعتمد على إصدار SDK. يمكن أن تحتوي إصدارات SDK على نماذج وخيارات مصادقة مختلفة؛ تحقق من الإصدار المثبت قبل تكييف الأمثلة.

## المتطلبات الأساسية

استخدم مفتاح واجهة برمجة تطبيقات، ومُصدر، ومفتاح توقيع مُدار متاح من نفس البيئة. لا يؤدي تسجيل المفتاح العام وحده إلى توفير مفتاح توقيع خاص. أكمل [إعداد مساحة العمل](https://docs.truthlocks.com/ar/quickstart.md) أولاً.

## سك العملة باستخدام Node.js

احفظ باسم `mint.mjs`. قم بتكوين متغيرات البيئة أدناه من خلال shell أو مدير الأسرار الخاص بك، ثم قم بتشغيل `node mint.mjs` بإصدار Node.js يدعم `fetch`.

```javascript theme={null}
import { randomUUID } from 'node:crypto';

const required = name => {
  const value = process.env[name];
  if (!value) throw new Error(`Set ${name}`);
  return value;
};
const baseUrl = (process.env.TRUTHLOCKS_BASE_URL ??
  'https://sandbox-api.truthlocks.com').replace(/\/$/, '');
const payload = Buffer.from(JSON.stringify({
  subject: 'demo-record', message: 'Example issuer claim'
}), 'utf8');
const body = {
  issuer_id: required('TRUTHLOCKS_ISSUER_ID'),
  kid: required('TRUTHLOCKS_KEY_ID'),
  alg: required('TRUTHLOCKS_ALGORITHM'),
  content_type: 'application/json',
  payload_b64url: payload.toString('base64url'),
};
// Persist this value with the body before issuing requests in a durable job.
const idempotencyKey = randomUUID();
const response = await fetch(`${baseUrl}/v1/attestations/mint`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': required('TRUTHLOCKS_API_KEY'),
    'Idempotency-Key': idempotencyKey,
  },
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Mint failed: HTTP ${response.status}`);
const record = await response.json();
console.log({ attestationId: record.attestation_id, recordedAt: record.issued_at_unix });
```

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

## التحقق وتفسير النتائج

أرسل المعرف المُعاد إلى [Verify](https://docs.truthlocks.com/ar/api-reference/verify.md). أضف `payload_b64url` الأصلي إذا كنت ترغب في التحقق من البايتات الدقيقة. افحص `verdict` و `reasons`؛ HTTP 200 وحده لا يثبت الصلاحية.

يثبت التوقيع علاقة تشفيرية بمفتاح التوقيع. لا يتحقق بشكل مستقل من صحة المطالبات المقدمة في العالم الحقيقي.

لإصدار مكتبة بايثون القياسية، راجع [quickstart](https://docs.truthlocks.com/ar/quickstart.md). للإلغاء والاستبدال، اتبع عقود الطلبات التي تم إنشاؤها لـ [revoke](https://docs.truthlocks.com/ar/api-reference/attestations/revoke.md) و [supersede](https://docs.truthlocks.com/ar/api-reference/attestations/supersede.md)؛ لا تعيد استخدام نص سك لعمليات كهذه.


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