Resource Conflict

conflict · 409

الطلب صحيح لكنه يتعارض مع حالة المورد الحالية، فرفضته الـ API بدل أن تنفذه.

كل الصفحات

أما التعارض على قيمة مكررة فيعيد نوعا خاصا به، مثل project-conflict.

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

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

  • نداء آخر طبق الـ changeset أو ألغاه، ثم حاول هذا الطلب استعماله.
  • قاعدة على المورد نفسه ترفض العملية: بيئة production لا تحذف.

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

  • اقرأ detail، ففيه القاعدة التي رفضت الطلب.
  • اقرأ المورد من جديد قبل أن تقرر. حالته تغيرت، فالخطة المبنية على الحالة القديمة أصبحت قديمة.
  • لا تعد المحاولة دون تفكير. إذا طبق نداء آخر الـ changeset، فإعادة المحاولة لا تطبق شيئا وتخفي السباق.

مثال على الرد

json
{
  "type": "conflict",
  "title": "Resource Conflict",
  "status": 409,
  "detail": "The changeset is no longer open",
  "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/changeset/apply",
  "method": "POST",
  "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply",
  "docs": "https://ghaym.me/docs/errors/conflict"
}