Bucket Not Found
bucket-not-found · 404
لم تعثر الـ API على bucket بهذا المعرف في الـ workspace الذي أرسل منه النداء.
كل الصفحات
المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ resourceId يحمل المعرف الذي بحثت عنه الـ API.
إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع resourceType و resourceId.
- المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر.
- حذف الـ bucket بين النداء الذي عرضه في القائمة وهذا النداء.
- أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header
X-Ghaym-Workspace، أو?workspace=<id>في البث حين يغيب الـ header.
- اقرأ
resourceIdوقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا.
- وإذا كان المعرف صحيحا وحديثا، فأرسل
X-Ghaym-Workspaceباسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء.
json
{
"type": "bucket-not-found",
"title": "Bucket Not Found",
"detail": "Bucket with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found",
"resourceType": "Bucket",
"resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
"requestId": "req-1785231000000-4f7b2c9ae",
"timestamp": "2026-07-28T09:30:00.000Z",
"path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
"method": "GET",
"instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
"status": 404,
"docs": "https://ghaym.me/docs/errors/bucket-not-found"
}