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