الانتقال إلى المحتوى الرئيسي
POST
صك إثبات
هذا هو نوع مسار التجميع لسك الشهادات. استخدم خيار السجل المنظم أو الحمولة المشفرة الموضح في Try It واحتفظ بنفس مفتاح Idempotency-Key عند إعادة محاولة نفس الطلب. تظل حزم التحقق وأنواع السجلات قابلة للتحديد في مخطط الطلب.

التفويضات

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

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

الترويسات

Idempotency-Key
string
مطلوب

الجسم

application/json

اختر سجل منظم لتحديد نوع السجل وإدخال المطالبات، أو حمولة مشفرة لتوقيع البايتات الموجودة. لا تجمع أبدًا بين تنسيقي الإدخال.

alg
enum<string>
مطلوب

يجب أن يتطابق مع مفتاح توقيع جهة الإصدار المحدد.

الخيارات المتاحة:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
issuer_id
string<uuid>
مطلوب

معرف UUID للمصدر الذي ينشئ الشهادة

مثال:

"550e8400-e29b-41d4-a716-446655440000"

kid
string
مطلوب

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

مثال:

"es256-key-1"

schema
enum<string>
مطلوب

نوع السجل للإدخال المنظم. قدم المطالبات واحذف payload_b64url. هذا التصنيف لا يتحقق بشكل مستقل من صحة المطالبات.

الخيارات المتاحة:
verifiable-id,
passport,
drivers-license,
government-id,
self-sovereign-id,
employment-verification,
professional-role,
membership-card,
professional-certification,
license,
accreditation,
degree,
completion-cert,
course-credit,
transcript,
micro-credential,
training-completion,
medical-license,
dea-registration,
board-certification,
health-credential,
vaccination-record,
aml-kyc,
security-clearance,
sam-gov,
jurisdiction-approval,
attestation-of-will,
bank-verification,
credit-attestation,
income-verification,
skill-badge,
competency,
industry-cert,
product-authenticity,
chain-of-custody,
origin-verification,
custom,
attestation
مثال:

"verifiable-id"

claims
object
مطلوب

حقول سجل منظمة. مطلوبة مع المخطط؛ لا يمكن دمجها مع payload_b64url.

مثال:
attestation_id
string
content_type
string

نوع MIME للبايتات الأصلية، مثل application/json أو application/pdf أو image/png. يتطلب إدخال المخطط/المطالبات المنظمة application/json.

مثال:

"application/json"

document_hash
string

تجزئة مستند SHA-256 سداسية عشرية اختيارية. تأخذ claims.document.sha256 المضمنة الأسبقية؛ وإلا يتم استخدام هذا الحقل، ثم تجزئة الحمولة المفككة.

pack_id
string<uuid>

معرف UUID لحزمة التحقق من مساحة العمل الاختيارية. استخدم قائمة حزم التحقق بنفس مفتاح API لتحديد حزمة نشطة موجودة؛ احذفها لسجل مستقل.

expires_at_unix
integer<int64>

طابع زمني Unix مستقبلي اختياري بالثواني لإدخال المخطط/المطالبات المهيكلة. يتم تضمينه في حمولة JSON الموقعة. بالنسبة لإدخال payload_b64url، احذف حقل الطلب هذا وقم بتضمين expires_at_unix في جذر حمولة JSON الدقيقة بدلاً من ذلك. لا يمكن تغيير تاريخ انتهاء الصلاحية في مكانه.

النطاق المطلوب: 1 <= x <= 253402300799
recipient_email
string<email>

مستلم اختياري للإشعار غير المتزامن بعد السك. لا يؤكد رد السك الناجح التسليم.

الاستجابة

تم سك الإشهاد

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
الخيارات المتاحة:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>