Resource Not Found

resource-not-found · 404

الـ 404 الذي تعلنه وثيقة OpenAPI الخاصة بالـ API لكل مورد، ولا يرسله أي مسار اليوم.

كل الصفحات

كل مورد مفقود غيره يعيد نوعا خاصا به، مثل project-not-found. وكلها تحمل resourceType و resourceId.

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

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

  • المورد مفقود، أو لا يراه صاحب الطلب.

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

  • طابق type على اللاحقة -not-found لا على هذا الـ slug، لكي تتعامل مع كل مورد مفقود بالطريقة نفسها.
  • تحقق من المعرف في المسار مقابل resourceId، فهو يسمي المورد الذي بحث عنه الطلب.
  • وتجد كل أنواع المورد المفقود في الفهرس.

مثال على الرد

json
{
  "type": "resource-not-found",
  "title": "Resource Not Found",
  "detail": "Resource with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403' was not found",
  "resourceType": "Resource",
  "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403/env/resolved",
  "method": "GET",
  "instance": "GET /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403/env/resolved",
  "status": 404,
  "docs": "https://ghaym.me/docs/errors/resource-not-found"
}