Project Conflict

project-conflict · 409

يوجد مشروع آخر في هذا الـ workspace له قيمة name نفسها، فلم يكتب أي شيء.

كل الصفحات

الـ conflictField يسمي الحقل، والـ conflictValue القيمة التي رفضت.

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

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

  • يوجد مشروع آخر في هذا الـ workspace يستعمل قيمة name نفسها.
  • أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته.
  • طلب تغيير الاسم اسما يحمله مشروع آخر في الـ workspace نفسه.

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

  • اقرأ conflictField و conflictValue، فهما يذكران أي قيمة رفضت.
  • اختر قيمة name أخرى، أو اجلب المشروع الذي له هذه القيمة واستعمله.
  • وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا.
  • وأرسل header اسمه Idempotency-Key مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها.

مثال على الرد

json
{
  "type": "project-conflict",
  "title": "Project Conflict",
  "detail": "A project with name 'storefront' already exists",
  "resourceType": "Project",
  "conflictField": "name",
  "conflictValue": "storefront",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects",
  "method": "POST",
  "instance": "POST /v1/projects",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/project-conflict"
}