Gateway Timeout

gateway-timeout · 504

النوع الاحتياطي لـ 504 ليس له نوع باسمه، ولا يوجد مسار في الـ API يرسله اليوم.

كل الصفحات

وكأي مهلة تنتهي، تكون نتيجة العملية غير معروفة: فقد تكون اكتملت بعد إرسال الجواب.

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

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

  • خطأ 504 صدر دون نوع خاص به ووصل إلى معالج الأخطاء.

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

  • اقرأ المورد من جديد قبل أن تعيد محاولة الكتابة، لكي لا تنشئ إعادة المحاولة نسخة ثانية.
  • أرسل Idempotency-Key مع كل كتابة؛ فهو الذي يجعل هذه الحالة بالذات آمنة للإعادة.
  • أعد المحاولة وأطل الانتظار كل مرة، وتوقف بعد بضع محاولات.

مثال على الرد

json
{
  "type": "gateway-timeout",
  "title": "Gateway Timeout",
  "status": 504,
  "detail": "The upstream service did not respond in time",
  "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/gateway-timeout"
}