Insufficient Permission

insufficient-permission · 403

الـ 403 الذي تعلنه وثيقة OpenAPI الخاصة بالـ API، وفيه requiredPermission يسمي الصلاحية التي تنقص صاحب النداء.

كل الصفحات

وقت التشغيل، تعيد الصلاحية المرفوضة forbidden-access بدلا منه، فتعامل مع الاثنين.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع requiredPermission.

الأسباب الشائعة

  • لا يملك الحساب الصلاحية التي تحتاجها العملية، مثل cloud:projects:delete.

كيف تصلح الطلب

  • اقرأ requiredPermission وأخبر المستخدم بالصلاحية الناقصة تحديدا.
  • لا تعد المحاولة، ولا تحاول إجراء التغيير نفسه من endpoint آخر.

مثال على الرد

json
{
  "type": "insufficient-permission",
  "title": "Insufficient Permission",
  "status": 403,
  "detail": "Your account is not permitted to perform this action (missing: cloud:projects:delete)",
  "requiredPermission": "cloud:projects:delete",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "method": "DELETE",
  "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "docs": "https://ghaym.me/docs/errors/insufficient-permission"
}