curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
واجهة الإدارة — الرموز والاستخدام
إزالة رمز API
DELETE /console/token//
DELETE
/
console
/
token
/
{key}
/
curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
يُلغي مفتاح Management API نهائيًا. مثل إنشاء رمز، تقع نقطة النهاية هذه على مضيف Scanova API العادي (
qcg-api.scanova.io) وتُصادَق برمز وصول OAuth العادي الخاص بلوحة التحكم — لا بالمفتاح الذي تحذفه.
الطلب
DELETE https://qcg-api.scanova.io/console/token/{key}/
Authorization: Bearer <your_oauth_access_token>
string
مطلوب
قيمة المفتاح الكاملة التي أُعيدت عند إنشاء الرمز (وليست معرّفًا رقميًا).
curl -X DELETE "https://qcg-api.scanova.io/console/token/401f7ac837da42b97f613d789819ff93537bee6a/" \
-H "Authorization: Bearer <your_oauth_access_token>"
السلوك
- الإزالة الناجحة تعيد
204 No Contentبنص فارغ. - بمجرد الحذف، يتوقف المفتاح عن المصادقة على مضيف البيانات فورًا — أي طلبات جارية أو لاحقة تستخدمه تحصل على
401. - يمكنك حذف مفتاح تملكه فقط (أو، بالنسبة لمستخدم مشارك، مفتاحًا أنشأه ذلك المستخدم المشارك).
الحذف يعيد أيضًا فحص حصة الخطة باستخدام قيمة
environment، بالقيمة الافتراضية sandbox إذا لم تمرر واحدة — نفس القاعدة الموصوفة في صفحة إنشاء رمز. نادرًا ما يهم هذا عمليًا لأن الخطط التي تمنح وصول Management API تمنحه عادةً عبر كل البيئات، لكن مرّر ?environment=live صراحة إذا واجهت 401 غير متوقع عند حذف مفتاح بيئة live.لا توجد حالة “تعطيل” أو “إيقاف مؤقت” — الإزالة فورية ودائمة. إذا كنت بحاجة فقط لإيقاف استخدام مفتاح مؤقتًا، لا تحذفه؛ أنشئ مفتاحًا جديدًا وتوقف عن استخدام القديم، أو نسّق مع التكامل الذي يستهلكه قبل حذفه.
ذات صلة
- نظرة عامة على Management API — بنية المصادقة ذات المضيفين التي تنتمي إليها نقطة النهاية هذه.
- إنشاء رمز API — أنشئ مفتاحًا بديلًا، واطّلع على قواعد السرد/الحصص التي تشترك فيها نقطة النهاية هذه.
- إحصاءات الاستخدام — تحقق من استخدام مفتاح قبل تقرير إزالته.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
معلمات المسار
الاستجابة
204
Token removed
هل كانت هذه الصفحة مفيدة؟
⌘I