Errors – коды ответов и обработка ошибок API

Команда Quickex

24 августа 2025 г.

~1 мин. чтения

2xx Success

4xx Client Error

5xx Server Error

Quickex использует стандартные коды HTTP для обозначения результата запроса:
2xx — успех,
4xx — ошибка в данных/правах запроса,
5xx — ошибка на стороне сервера (редко).

Некоторые 4xx содержат краткий
error.code и сообщение для программной обработки.

Рекомендации по обработке

Логируйте HTTP status и тело ответа.
Для 429 и временных 5xx используйте повтор с экспоненциальной паузой (backoff + jitter).
Проверяйте обязательные параметры перед отправкой запроса.

Код	Название	Описание
200	OK	Всё сработало как ожидалось.
400	Bad Request	Некорректный запрос (часто отсутствует обязательный параметр).
401	Unauthorized	Нет действительного токена/ключа.
402	Request Failed	Параметры верны, но операция не выполнена.
403	Forbidden	Недостаточно прав для выполнения запроса.
404	Not Found	Ресурс не существует.
409	Conflict	Конфликт с текущим состоянием (дубликат, несогласованность и т.п.).
424	External Dependency Failed	Сбой внешней зависимости, мешающий выполнить запрос.
429	Too Many Requests	Превышен лимит — уменьшите частоту, примените backoff.
500, 502, 503, 504	Server Errors	Ошибка на стороне сервера. Повторите позже (с backoff).

Информационная сводка

Quickex использует стандартные коды HTTP. 2xx — успех; 4xx — ошибки валидации/прав доступа/клиентские; 5xx — ошибки сервера (редко). Обрабатываемые 4xx содержат код ошибки и сообщение. Для 429 и временных 5xx используйте экспоненциальный backoff с джиттером. Всегда логируйте статус и тело ответа.

Поделиться статьей:

Ошибки