الانتقال إلى المحتوى الرئيسي
POST
صك إيصال
ينشئ حدث إيصال موقع تشفيريًا ومثبتًا في سجل الشفافية. يتم التحقق من صحة الإيصالات مقابل مخطط نوع الإيصال المسجل قبل التوقيع.

أنواع الإيصالات

الرؤوس

الاستجابة

string
معرّف UUID للإيصال الذي تم إنشاؤه.
string
اسم نوع الإيصال.
string
active
string
معرّف UUID للمُصدر الموقّع.
string
معرّف الموضوع.
object
التوقيع التشفيري: alg، kid، value.
string
طابع زمني ISO 8601.

حدث Webhook

يتم تسليم حدث webhook لـ receipt.created إلى جميع نقاط النهاية المكونة بعد سك ناجح.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

الترويسات

Idempotency-Key
string
مطلوب

معرف UUID لسك العمليات المتطابقة

الجسم

application/json
issuer_id
string
مطلوب

معرف UUID للمُصدر الذي يوقع الإيصال

kid
string
مطلوب

معرف المفتاح لمفتاح التوقيع

payload
any
مطلوب

تم التحقق من حمولة الإيصال مقابل المخطط

receipt_type
string
مطلوب

اسم نوع الإيصال

subject
string
مطلوب

معرف الموضوع

alg
enum<string>

خوارزمية التوقيع المطابقة للمفتاح.

الخيارات المتاحة:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
metadata
any

بيانات وصفية اختيارية

receipt_version
string
retention_policy
string

الاستجابة

تم إنشاء الإيصال

receipt_id
string
receipt_type
string
status
string
issuer_id
string
subject
string
signature
object
issued_at
string