Справка по кодам ответов 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)

6 Превышен лимит количества токенов

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