تیم Quickex

۱۰ شهریور ۱۴۰۴

~1 دقیقه خوانده شده

2xx موفقیت

4xx خطای کاربر

5xx خطای سرور

Quickex از کدهای استاندارد HTTP برای نشان دادن نتیجه درخواست استفاده می‌کند:
2xx — موفقیت،
4xx — خطا در داده‌ها/مجوز درخواست،
5xx — خطای سمت سرور (نادر).

برخی کدهای 4xx شامل یک
error.code کوتاه و پیامی برای پردازش برنامه‌ای هستند.

توصیه‌های پردازش

وضعیت HTTP و بدنه پاسخ را لاگ کنید.
برای 429 و خطاهای موقتی 5xx از تکرار با مکث نمایی (backoff + jitter) استفاده کنید.
قبل از ارسال درخواست، پارامترهای اجباری را بررسی کنید.

کد	نام	توضیحات
200	OK	همه چیز طبق انتظار کار کرد.
400	درخواست نادرست	درخواست نامعتبر (اغلب یک پارامتر اجباری وجود ندارد).
401	Unauthorized	هیچ توکن/کلید معتبری وجود ندارد.
402	درخواست انجام نشد	پارامترها درست هستند اما عملیات انجام نشد.
403	ممنوع	دسترسی کافی برای اجرای درخواست وجود ندارد.
404	یافت نشد	منبع وجود ندارد.
409	تضاد	تضاد با وضعیت فعلی (تکراری، ناسازگاری و غیره).
424	شکست وابستگی خارجی	خرابی یک وابستگی خارجی مانع اجرای درخواست شد.
429	درخواست‌های زیاد	محدودیت فراتر رفته — نرخ را کاهش دهید، backoff اعمال کنید.
500, 502, 503, 504	خطاهای سرور	خطای سمت سرور. بعداً دوباره امتحان کنید (با backoff).

خلاصه اطلاعات

Quickex از کدهای استاندارد HTTP استفاده می‌کند. 2xx — موفقیت؛ 4xx — خطاهای اعتبارسنجی/دسترسی/کاربر؛ 5xx — خطاهای سرور (نادر). خطاهای 4xx قابل پردازش شامل کد خطا و پیام هستند. برای 429 و 5xx موقتی از backoff نمایی با jitter استفاده کنید. همیشه وضعیت و بدنه پاسخ را لاگ کنید.

این مقاله را به اشتراک بگذارید: