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"
}