Unprocessable Entity

unprocessable-entity · 422

ترسل الـ API هذا النوع عندما يشير مرجع إلى خدمة أو قاعدة بيانات في موقع آخر.

كل الصفحات

يُرفض المرجع بـ code: reference_across_sites، وحقوله تسمي طرفيه: service وserviceSite للخدمة التي تحمل المرجع، وtarget وtargetSite للخدمة التي يسميها. والـ 422 الذي ترسله الـ API فعلا هو idempotency-key-reused.

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

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

  • مرجع ${{Service.VAR}} يسمي خدمة أو قاعدة بيانات في موقع آخر.

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

  • اقرأ targetSite وserviceSite. المرجع يعمل داخل موقع واحد فقط، فوجهه إلى خدمة أو قاعدة بيانات في الموقع نفسه.
  • للوصول إلى خدمة web في موقع آخر، ضع رابطها العام، لا مرجعا.
  • لا تعد المحاولة دون تغيير، فالمرجع نفسه سيرفض مرة أخرى.

مثال على الرد

json
{
  "type": "unprocessable-entity",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The request could not be processed",
  "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",
  "docs": "https://ghaym.me/docs/errors/unprocessable-entity"
}