Internal Server Error

internal-error · 500

حدث عطل لدينا، وقد يكون الطلب نفذ وقد لا يكون.

كل الصفحات

الـ 500 يعني أن الخادم لم ينه عمله بسلام، لا أنه لم يفعل شيئا. وفي الـ production يكون الـ detail الجملة نفسها كل مرة، والتفاصيل في سجلاتنا تحت الـ requestId الخاص بهذا الجواب.

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

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

  • خلل في الخدمة.
  • شيء تعتمد عليه الخدمة تصرف بطريقة غير متوقعة.

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

  • احتفظ بـ requestId. فهو القيمة الوحيدة التي تجد هذا العطل بالذات، فاذكره عندما تبلغ عن المشكلة.
  • أعد المحاولة مرة واحدة بعد تأخير. إذا فشلت مرة أخرى، فتوقف بدل أن تستمر في الدوران.
  • قبل أن تعيد محاولة كتابة، اقرأ المورد من جديد. فقد تكون المحاولة الأولى نفذت جزءا منها.
  • لا تقل إن الـ deploy نجح لمجرد أن إعادة المحاولة أعادت 200: راجع سجل الـ build.

مثال على الرد

json
{
  "type": "internal-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred. Please try again later.",
  "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/internal-error"
}