Общая информация
Доступ к публичному API осуществляется посредством HTTP-запросов и реализован с использованием принципов REST. Базовым URI для веб-службы является:
https://api.avtoit.com/base/
Прием данных осуществляется в кодировке UTF-8.
Для отладки вы можете воспользоваться расширением Postman Interceptor для обозревателя Google Chrome.
Запрос
Запросы на получение данных осуществляются с помощью HTTP-метода GET. В структуре сервиса имеется понятие операции. Операция указывается в качестве пути в URL. Параметры передаются как строка запроса HTTP (GET). Большая часть операций исполняется от имени конкретного пользователя и требует идентификации с помощью параметров apiId (ID пользователя в системе) и apiKey (API ключ). Каждая операция может иметь список дополнительных параметров, определяемых контекстом операции. Например, вызов операции "список брендов" может выглядеть следующим образом:
https://api.avtoit.com/base/article/ brand/?apiId=******* &apiKey=******* &article=2110076
Ответ
В случае успешного исполнения операции, веб-служба вернет ответ с HTTP-кодом 200 и телом ответа в виде JSON. Формат ответа определяется каждой операцией.
Любой ответ с HTTP-кодом 400 и более является ошибочным, в теле содержит код ошибки и, как правило, текстовое сообщение описывающее причины возникшей ошибки также в виде JSON.