Error Codes

В этом разделе перечислены общие коды ошибок, которые может возвращать 1Bridge API, и их возможные значения. Конкретные детали ошибки обычно содержатся в поле description JSON-ответа.

Обзор Кодов Состояния HTTP

• 2xx (Успех):
  • 200 OK: Запрос успешно обработан. Тело ответа содержит запрошенные данные (для GET) или статус операции (для POST/PUT/DELETE).
  • 201 Created: Ресурс успешно создан (редко используется в текущих эндпоинтах).
  • 204 No Content: Запрос успешно обработан, но тело ответа намеренно пустое (например, после DELETE).
• 4xx (Ошибка Клиента):
  • 400 Bad Request: Запрос некорректен из-за ошибки на стороне клиента (неверный формат JSON, отсутствуют обязательные поля, невалидные значения). См. поле description для деталей.
  • 401 Unauthorized: Ошибка аутентификации. Предоставленный Bearer-токен недействителен, просрочен, или X-Partner-Id не соответствует токену.
  • 403 Forbidden: Аутентификация пройдена, но у данного партнера/токена нет прав на выполнение запрошенной операции.
  • 404 Not Found: Запрошенный ресурс (например, заказ с указанным ID) не найден.
  • 429 Too Many Requests: Превышен лимит запросов (rate limiting).
• 5xx (Ошибка Сервера):
  • 500 Internal Server Error: Произошла непредвиденная ошибка на стороне сервера 1Bridge при обработке запроса. Попробуйте повторить запрос позже или свяжитесь с поддержкой.
  • 503 Service Unavailable: Сервер временно недоступен (например, из-за технического обслуживания или перегрузки).

Внутренние Коды Ошибок (в теле ответа 4xx/5xx)

В теле ответа для ошибок 4xx и 5xx может присутствовать поле code с внутренним кодом ошибки платформы 1Bridge для более точной диагностики.

Код	HTTP Статус	Описание
4001	400	Неверное значение в поле {field}
4002	400	Отсутствует обязательное поле {field}
4003	400	Некорректный формат JSON
4010	401	Невалидный или просроченный токен доступа
4011	401	Неверный X-Partner-Id для данного токена
4030	403	Недостаточно прав для операции
4041	404	Ресурс (заказ, товар) с ID {id} не найден
5000	500	Общая внутренняя ошибка сервера
5001	500	Ошибка при взаимодействии с системой 1С
5002	500	Ошибка при взаимодействии с внешним API