Invoice Not Found

invoice-not-found · 404

لم تعثر الـ API على فاتورة بهذا المعرف في الـ workspace الذي أرسل منه النداء.

كل الصفحات

المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ resourceId يحمل المعرف الذي بحثت عنه الـ API.

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

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

  • المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر.
  • أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header X-Ghaym-Workspace، أو ?workspace=<id> في البث حين يغيب الـ header.

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

  • اقرأ resourceId وقارنه بالقيمة التي قصدت إرسالها.
  • اطلب القائمة من جديد بـ ghaym cloud billing invoices list وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا.
  • وإذا كان المعرف صحيحا وحديثا، فأرسل X-Ghaym-Workspace باسم الـ workspace الذي فيه المورد.
  • لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء.

مثال على الرد

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