LogoAPI Documentation

Коды статуса HTTP и основные коды ошибок


Коды статуса HTTP

Успешность выполнения запроса к Alloka API определяется HTTP-кодом ответа.

Таблица 1. Основные коды статуса HTTP, используемые в Alloka API.

Код статуса HTTP Описания значения в Alloka API
400 Bad request

Неправильные входные данные.

Причины:

— Некорректный JSON.

— Неправильные или отсутствующие параметры запроса.

Рекомендации:

— Проверьте валидность вашего JSON — http://jsonlint.com.

— Внимательно проверьте соответствие вашего запроса данной документации.

401 Unauthorized

Неавторизованный доступ.

Причины:

— Отсутствует API-ключ.

— Передан неправильный или пустой API-ключ.

Рекомендации:

— Удостоверьтесь, что вы правильно передаёте API-ключ авторизации (см. выше).

— Проверьте, что вы используете актуальный API-ключ в вашем профиле в личном кабинете Аллока Аналитика.

403 Forbidden

Доступ к запрашиваемому ресурсу запрещён.

Причины:

— Запросы к разделам API, предназначенных для агентств при авторизации от обычного пользователя.

Рекомендации:

— Удостоверьтесь, что вы авторизуетесь от пользователя, который является менеджером агентства.

— В случае, если вы исполняете запросы от обычного пользователя, разделы для агентств не будут вам доступны.

404 Not Found

Запрашиваемый ресурс не найден.

Причины:

— Неправильный URL запроса.

— Ресурс с запрашиваемым ID не найден.

Рекомендации:

— Проверьте, что URL запроса соответствует тому, что приведён в данной документации.

— Возможно, запрашиваемый ресурс удалён или принадлежит другом пользователю. Выполните запрос списка ресурсов, посмотрите есть ли требуемый ресурс в ответе.

500 Internal Server Error

502 Bad Gateway

503 Service Unavailable

504 Gateway Timeout

Внутренняя ошибка.

Причины:

Внутренний сбой работы системы.

Рекомендация:

При возникновение получении таких кодов статуса — напишите нам на support@alloka.ru, указав в письме детали запроса к API (точное время, URL, параметры запроса).

В случае, если вы уверены, что ваш запрос корректен, но вам выдаётся ошибка, напишите нам на support@alloka.ru, указав в письме детали запроса к API (точное время, URL, параметры запроса).

Основные коды ошибок

В случае неудачного запроса в ответе будет содержаться поле error, которое может быть строкой или ассоциативным массивом строк.

Таблица 2. Основные коды ошибки запросов, используемые в Alloka API.

Код ошибки Описание
invalid_json

Неправильный JSON.

Причины:

— Ошибка парсинга JSON, переданного в теле запроса.

Рекомендации:

— Проверьте валидность вашего JSON — http://jsonlint.com

invalid_request

Неправильный URL запроса.

Причины:

— Запрашиваемый запрос в Alloka API не существует.

Рекомендации:

— Проверьте, что URL запроса соответствует тому, что приведён в данной документации.

unauthorized

Неавторизованный доступ.

Причины:

— Отсутствует API-ключ.

— Передан неправильный или пустой API-ключ.

Рекомендации:

— Удостоверьтесь, что вы правильно передаёте API-ключ авторизации (см. выше).

— Проверьте, что вы используете актуальный API-ключ в вашем профиле в личном кабинете Аллока Аналитика.

access_denied

Доступ к запрашиваемому ресурсу запрещён.

Причины:

— Запросы к разделам API, предназначенных для агентств при авторизации от обычного пользователя.

Рекомендации:

— Удостоверьтесь, что вы авторизуетесь от пользователя, который является менеджером агентства.

— В случае, если вы исполняете запросы от обычного пользователя, разделы для агентств не будут вам доступны.

not_found

Не найдено.

Причины:

— Запрашиваемый ресурс не найден

Рекомендации:

— Возможно, запрашиваемый ресурс удалён или принадлежит другом пользователю. Выполните запрос списка ресурсов, посмотрите есть ли требуемый ресурс в ответе.

unknown_error

Внутренняя ошибка.

Причины:

Внутренний сбой работы системы.

Рекомендация:

При возникновение получении таких кодов статуса — напишите нам на support@alloka.ru, указав в письме детали запроса к API (точное время, URL, параметры запроса).

В случае, если вы уверены, что ваш запрос корректен, но вам выдаётся ошибка, напишите нам на support@alloka.ru, указав в письме детали запроса к API (точное время, URL, параметры запроса).

Кроме того, каждый запрос может обладать своими кодами ошибок, о чём указано в описании запросов к Alloka API.