#309: Справка по кодам ответов API

Отредактирована: 73 дня назад
  • в случае положительного результата будет возвращен ответ с кодами 200, 201 или 202.
  • в случае неправильного URL будет возвращен ответ с кодом 404.
  • в случае недостаточных прав для осуществления операции будет возвращен ответ с кодом 403 или 401.
  • в случае каких-либо ошибок будет возвращен ответ с кодом 400 или 500.
  • в случае превышения максимального количества запросов за период будет возвращен ответ с кодом 503. Действующее ограничение - не более 600 запросов в минуту для приложения.

API server возвращает ответ в формате JSON. В случае ошибки, ответ сервера будет выглядеть следующим образом:

HTTP/1.1 401 UNAUTHORIZED  

Server: nginx/1.2.3  

Date: Mon, 17 Sep 2012 10:07:39 GMT  

Content-Type: application/json; charset=utf-8  

Transfer-Encoding: chunked  

Connection: keep-alive  

Vary: Authorization, Cookie  

WWW-Authenticate: Bearer realm="", error="invalid_token", error_description="Token doesn't exist"  

Content-Language: ru  

Set-Cookie: section=advertiser; expires=Tue, 17-Sep-2013 13:07:39 GMT; Path=/  

  

{"error_description": "Token doesn't exist", "error_code": 1, "error": "invalid_token"}

В передаваемых данных присутствует название ошибки error. Также может быть дополнительная информация:

  • error_description — описание ошибки
  • error_code — дополнительный код ошибки

Дополнительные коды ошибок:

ЗначениеОписание
0Время действия ключа истекло
1Неправильный или недействительный ключ
2Ключ не имеет достаточных прав доступа для осуществления операции
3Неправильный запрос
4Превышение максимального количество запросов за период
5Отсутствует такой токен обновления (refresh token)
6Превышен лимит количества токенов