مرجع API · تسجيل المفتاح

قراءة دعوة

GET/v1/enrollments/{invitationId}

حالة الدعوة ووقت انتهاء صلاحيتها. مُصرَّح به برمز التسجيل لا بتوقيع.

الصلاحيةلا شيء

المصادقةرمز التسجيل

ردّ أنيسموقَّع

حدود الموظفين التي يُحتسب ضمنهالا شيء

حزمة SDK لـ ‎.NETenrollment.GetAsync()

المعاملات

الاسم	الموضع	النوع	ملاحظات
`invitationId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.

الاستدعاء

مُصرَّح به عبر Authorization: Enrollment <token>؛ غير موقَّع.

الترويسات: Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: لا يوجد.

الردود

الحالة	المعنى	المحتوى
200	نجاح.	EnrollmentState
401	مرفوض: لم تتم المصادقة.	مشكلة
404	مرفوض: غير موجود، أو ليس لك.	مشكلة
429	مرفوض: بلغتَ حدًا.	مشكلة
503	لا قرار: خدمة مطلوبة غير متاحة.	مشكلة

كل ردّ على هذا الاستدعاء موقَّع من أنيس — النجاح وكل رفض. اشترط وجود التوقيع وتحقّق منه قبل أن تتصرف بناءً على الردّ؛ والردّ بلا توقيع فشل، لا يُعدّ ردًّا (كيف).

حالات الرفض

كل رفض لهذا الاستدعاء مشكلةٌ موقَّعة. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

الخطأ	الرمز	الحالة
الدعوة غير صالحة	`invitation_invalid`	401
غير موجود	`resource_not_found`	404
تجاوزت حدّ الاستدعاءات	`rate_limited`	429
الخدمة غير متاحة	`dependency_unavailable`	503
انتهت مهلة الاستدعاء	`request_timeout`	504
خطأ داخلي	`internal_error`	500

الأنواع

EnrollmentState

الحقل	النوع	ملاحظات
`invitationId`	UUID	الدعوة.
`applicationId`	UUID	التطبيق الذي يُسجَّل له المفتاح.
`state`	string	`pendingInvitation` أو `pendingProof` أو `pendingApproval` أو `active` أو `unavailable`.
`expiresAt`	string (date-time)	وقت انتهاء صلاحية الدعوة — بعد 24 ساعة من إصدارها.