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

  • в случае положительного результата будет возвращен ответ с кодами 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=webmaster; 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)