إلغاء مفتاح واجهة برمجية
إلغاء مفتاح واجهة برمجية
DELETE
/v1/projects/{projectId}/keys/{keyId}تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
يضبط revoked_at فيتوقف المفتاح عن المصادقة فورًا، ويعيد تعارضًا إذا كان ملغيًا بالفعل.
حد المعدّل: 60 طلبًا لكل 60 ثانية لكل جلسة.
رموز الخطأ: unauthorized (401), not_found (404),
already_revoked (409).
المصادقة
- sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
projectId | path | string (Ulid) | نعم | — |
keyId | path | string (Ulid) | نعم | — |
جسم الطلب
لا تأخذ هذه العملية جسم طلب.
الاستجابات
| الرمز | المعنى |
|---|---|
204 | أُلغي المفتاح. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
409 | يتعارض الطلب مع الحالة الحالية للمورد. يذكر وصف العملية قيم error.code الدقيقة. |
429 | تم تجاوز حد المعدّل. |