Вернуться наверх
На этой странице:

Обработка ошибок ​

  1. При успешном завершении операции сервер возвращает клиенту статус "200 OK".

  2. Если в ходе выполнения операции возникла ошибка, сервер возвращает клиенту JSON-структуру с описанием ошибки. Структура ошибки:

    json
    {
"code": "string",
"domain": "string",
"details": {
	"key1": "string",
	"key2": "string"
}
}

    где:

    • code — уникальный строковый идентификатор ошибки (код ошибки);

    • domain — место возникновения ошибки: hub, billing, backoffice, <имя_вендора> и так далее;

    • details — таблица типа "ключ:значение" со вспомогательными данными.

Список возможных ошибок ​

Код ошибкиОписание ошибкиHTTP статус
AccessDeniedУ пользователя нет доступа к запрашиваемому ресурсу403 Forbidden
ConflictingDataОтправленные данные конфликтуют с данными на сервере409 Conflict
ServiceIsBusyByAnotherOperationСервис занят другой операцией423 Locked
ServicePreconditionFailedTryLaterСервис не может выполнить запрос, но ожидается, что сможет в будущем412 PreconditionFailed
ServicePreconditionFailedСервис не может выполнить запрос, и не сможет в будущем так как запрос некорректен412 PreconditionFailed
ResourceNotFoundРесурс, к которому выполняется запрос, не найден404 Not found
RequestBodyIsNotValidТело запроса не прошло валидацию400 Bad request
RequestHeadersIsNotValidЗаголовки запроса не прошли валидацию400 Bad request
RequestPathIsNotValidPath-параметры запроса не прошли валидацию400 Bad request
RequestQueryIsNotValidQuery-параметры запроса не прошли валидацию400 Bad request
QuotaExceededПревышены квоты402 Payment required
LimitExceededПревышены лимиты402 Payment required
UnauthorizedЗапрос не авторизован401 Unauthorized
InternalErrorВнутренняя ошибка500 Internal error
PaymentRequiredНедостаточно средств402 Payment required
WrongLocationПродукт не может быть предоставлен в данном регионе406 Not acceptable
TrialPeriodAlreadyUsedПробный (trial) период уже был использован402 Payment required
NotImplementedМетод не поддерживается сервером501 Not Implemented
NoResourcesСервис не может выполнить запрос, так как у него закончились ресурсы503 Service Unavailable

Ошибки в асинхронных вызовах ​

  • При выполнении вызова асинхронных операций сервер в обязательном порядке возвращает объект Operation.
  • Если при выполнении операции возникнет ошибка, то в объект Operation в поле error будет добавлено сообщение Status.