إنشاء مفتاح واجهة برمجية

تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.

ينشئ مفتاح مشروع بصلاحيات محددة عبر جلسة لوحة التحكم. تعرض الاستجابة keyRaw مرة واحدة فقط، بينما يُخزَّن تجزئة argon2id وحدها.

حد المعدّل: 60 طلبًا لكل 60 ثانية لكل جلسة.

رموز الخطأ: unauthorized (401), not_found (404), invalid_name (400), invalid_scopes (400), key_generation_failed (500).

المصادقة

• sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

المعاملات

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: ApiKeyCreateRequest

{
  "name": "backend-server",
  "scopes": [
    "read",
    "write"
  ]
}

الاستجابات

مثال على الطلب

{
  "name": "backend-server",
  "scopes": [
    "read",
    "write"
  ]
}