Resource Not Found

not-found · 404

لا يوجد مسار في الـ API يطابق الطلب، أي أن الـ endpoint نفسه غير موجود.

كل الصفحات

أما المورد المفقود على مسار موجود فيعيد نوعا خاصا به، مثل project-not-found، فتميز بين الحالتين دون أن تقرأ نصا.

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

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

  • المسار مكتوب خطأ، أو تنقصه البادئة /v1.
  • الـ method خاطئ لمسار موجود، مثل أن ترسل POST إلى مجموعة تخدم GET فقط.
  • الـ endpoint مفترض ولم يتحقق منه. ليس للـ HTTP API مرجع عام، فقد يكون endpoint يبدو بديهيا غير موجود.

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

  • قارن path بالمسار الذي قصدته، مع البادئة.
  • لا تتحسس الـ endpoints بتجريب صيغ مختلفة. استعمل الـ CLI ghaym لتشغيل غيم.

مثال على الرد

json
{
  "type": "not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested endpoint '/v1/projcts' does not exist. Please check the API documentation for available endpoints.",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projcts",
  "method": "GET",
  "instance": "GET /v1/projcts",
  "docs": "https://ghaym.me/docs/errors/not-found"
}