الانتقال إلى المحتوى الرئيسي
POST
إنشاء مفتاح API للمستهلك
ينشئ مفتاح API شخصي جديد للمستهلك المصادق عليه. يتم إرجاع السر الكامل مرة واحدة في الاستجابة ولا يمكن استرداده مرة أخرى — قم بتخزينه بأمان. يمكن لكل مستهلك الاحتفاظ بما يصل إلى 5 مفاتيح نشطة. تنتهي صلاحية المفاتيح تلقائيًا بعد 90 يومًا.

الاستجابات

التفويضات

Authorization
string
header
مطلوب

JWT للعمليات التي يبدأها المستخدم

الجسم

application/json
name
string
مطلوب

تسمية قابلة للقراءة من قبل الإنسان للمفتاح

الاستجابة

تم إنشاء مفتاح API. يظهر السر في هذا الرد فقط.

key_id
string<uuid>
name
string

تسمية مقروءة بشريًا للمفتاح

prefix
string

أول 12 حرفًا من المفتاح، لأغراض العرض

status
enum<string>
الخيارات المتاحة:
active,
revoked
scopes
string[]

نطاقات الأذونات الممنوحة لهذا المفتاح

created_at
string<date-time>
expires_at
string<date-time>

تنتهي صلاحية المفاتيح بعد 90 يومًا من الإنشاء

last_used_at
string<date-time>

وقت آخر طلب تم إجراؤه باستخدام هذا المفتاح

secret
string

قيمة مفتاح API كاملة (تُعرض مرة واحدة)