- в случае положительного результата будет возвращен ответ с кодами 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 | Превышен лимит количества токенов |