الانتقال إلى المحتوى الرئيسي
ثبّت الحزمة العامة:
استخدم Node.js 18 أو أحدث. الموارد الأساسية هي issuers وkeys وattestations وverify وaudit وreceipts. لا تفترض أن كل واجهة برمجة تطبيقات عامة لديها طريقة ملائمة في هذه الحزمة؛ استخدم مرجع العملية وclient.request عند الاقتضاء.

تكوين المصادقة

استراتيجية مفتاح API هي service، وليست apiKey. لعملية المستخدم، استخدم auth: { type: 'bearer', token } مع رمز مستخدم صالح. tenantId لا يقوم بالمصادقة أو تبديل مساحات العمل. لا تستخدم المصادقة الخاصة بالمستأجر فقط.

سك العملة

استخدم مُصدرًا موجودًا ومفتاحًا متاحًا للتوقيع من جانب الخادم. استخدم إما البايتات الأصلية المشفرة أو إدخال schema و claims المنظم.
عيّن جميع متغيرات البيئة الثلاثة قبل تشغيل المقتطف. للإدخال المنظم، استبدل payload_b64url بـ schema: "attestation" و claims: { subject: "demo-record" }؛ لا ترسل كلا الوضعين أبدًا. لا يوفر تسجيل المفتاح العام وحده مفتاح توقيع خاص.

إعادة المحاولات ومعالجة الاستجابة

يضيف العميل رأسًا لعدم التكرار إلى طلبات POST و PUT. يؤدي استدعاء طريقة جديدة إلى إنشاء مفتاح جديد، لذا فهو ليس إعادة محاولة آمنة لكتابة سابقة غير مؤكدة ما لم تحتفظ بنفس المفتاح وتمرره. يقبل client.request خيار idempotencyKey. تقتصر عمليات إعادة المحاولة التلقائية على القراءات وكتابات التصديق/الإيصال المدعومة بمفتاح صريح؛ لا يتم إعادة تشغيل الكتابات العشوائية لمجرد توفير مفتاح. افحص التحقق verdict وreasons. لا يُعد الوعد المحلول أو HTTP 200 وحده نتيجة تحقق صالحة. طابق إصدار الحزمة المثبتة مع إعلانات نوعها؛ المصدر المصحح حديثًا ليس دليلاً على أن إصدارًا أقدم مثبتًا يحتوي على الإصلاحات. راجع مثال HTTP المباشر لتكامل مستقل عن التبعيات و مرجع API للعقد الحالي.