Access Denied

forbidden-access · 403

الـ API تعرف من ينادي، لكن مقعده أو صلاحياته لا تسمح بهذا النداء.

كل الصفحات

الـ requiredPermission يسمي ما ينقص. عندما يكون المقعد أقل من المطلوب، يعدد غالبا المقاعد التي تمر، ويكون الـ resourceType هو Workspace. وعندما تنقص الحساب صلاحية، يعدد الصلاحيات الناقصة، مثل cloud:projects:delete، ويكون الـ resourceType هو Cloud.

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

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

  • مقعد من ينادي في الـ workspace هو viewer، والنداء يكتب. كل كتابة تحتاج developer أو أعلى.
  • النداء يخص المال، ولا يستطيع إجراءه إلا أدوار المنظمة التي يسميها، مثل owner و admin.
  • الحساب لا يملك صلاحية يحتاجها المسار، مثل صلاحية مسار إداري.
  • تطبيق changeset يحذف خدمة أو نسخة قاعدة يحتاج cloud:projects:delete. وعندها يكون resourceType هو Changeset.

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

  • اقرأ requiredPermission وأخبر المستخدم بما ينقص بالضبط، واذكر detail.
  • لا تعد المحاولة، ولا تحاول إجراء التغيير نفسه عبر endpoint آخر: كل المسارات تجري الفحص نفسه.
  • تغيير المقعد يجريه admin في الـ workspace، وليس شيئا تلتف عليه.

مثال على الرد

json
{
  "type": "forbidden-access",
  "title": "Access Denied",
  "detail": "Your seat in this workspace is 'viewer'; this action needs admin or developer",
  "requiredPermission": "admin, developer",
  "resourceType": "Workspace",
  "resourceId": "current",
  "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",
  "status": 403,
  "docs": "https://ghaym.me/docs/errors/forbidden-access"
}