Service Conflict

service-conflict · 409

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

كل الصفحات

الـ conflictField يسمي الحقل، والـ conflictValue القيمة التي رفضت. يكون name في كل الحالات تقريبا، وقد يصطدم موقعان أنشئا في اللحظة نفسها بالاسم نفسه على slug بدلا منه.

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

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

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

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

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

مثال على الرد

json
{
  "type": "service-conflict",
  "title": "Service Conflict",
  "detail": "A service with name 'storefront' already exists",
  "resourceType": "Service",
  "conflictField": "name",
  "conflictValue": "storefront",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services",
  "method": "POST",
  "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/service-conflict"
}