Bad Request

bad-request · 400

رفضت الـ API الطلب بسبب قاعدة لا تستطيع فحوص الحقول التعبير عنها، والـ detail يسمي القاعدة.

كل الصفحات

وعلى عكس validation-error، لا يحمل errors[]: الشرح في detail. ويضيف الرفض لإطلاق لم يسم موقعا openSites، وهي المواقع المفتوحة للخدمات الجديدة.

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

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

  • معرفان يجب أن ينتميا معا وهما ليسا كذلك، مثل بيئة من مشروع غير مشروع الخدمة.
  • لا تنطبق العملية على هذا النوع من الخدمات: خدمات الـ web وحدها تنشر وتأخذ domain خاصا.
  • معرف في الـ path غير سليم. يجب أن يكون UUID v7، أو slug عندما يقبل المسار slug.
  • إطلاق كان سينشئ خدمة دون أن يسمي موقعا، ولا شيء يختار لها واحدا.

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

  • اقرأ detail. فهو مكتوب لهذه الحالة بالذات، ويسمي القاعدة التي خرقت.
  • عند site_required، مرر --site مع واحد من openSites. وعندما تكون openSites فارغة، يقول detail: No site is open.
  • تأكد أن كل معرف في الطلب ينتمي إلى المشروع نفسه.
  • لا تعد المحاولة دون تغيير، فالطلب نفسه سيرفض مرة أخرى.

مثال على الرد

json
{
  "type": "bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Environment belongs to a different project",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "docs": "https://ghaym.me/docs/errors/bad-request"
}