API ЕАИСТО (проверка страховок)

Документация по работе с API ЕАИСТО

Данный модуль теперь является частью модуля gibdd как type=eaisto, документация по API ГИБДД

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP POST на URL нашего API: https://api-cloud.ru/api/eaisto.php с персональным ключом API и параметрами.
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON {"status":200,"count":0, message: Ограничения отсутствуют}.

К API-CLOUD ЕАИСТО есть 2 типа запросов История изменений

type (тип)	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
vin	Проверка ТО по VIN коду	Обязательные vin - VIN авто Разрешено: латиница, цифры, знак "-" token - персональный ключ API
regnum	Проверка ТО по регистрационному номеру	Обязательные regnum - Регистрационный номер авто Разрешено: кирилица, цифры, знак "-" token - персональный ключ API

Токен (token) можно передавать в заголовках (headers). Указываем в заголовке Token: ВАШ_ТОКЕН

Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Основная информация по VIN номеру или Рег. номеру

Пример запроса "Проверка ТО по VIN коду" HTTP POST на URL нашего API

https://api-cloud.ru/api/eaisto.php?type=vin&vin=XTA1116******1192&token=53ba1b7a55abbB014aa97eff3a522079

Пример запроса "Проверка ТО по регистрационному номеру" HTTP POST на URL нашего API

https://api-cloud.ru/api/eaisto.php?type=regnum&regnum=С8***МУ**&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу vin или regnum с сайта ЕАИСТО в формате JSON

{
  "status": 200, // Статус ответа
  "diagnose_cards": [
    {
      "date": null, // Период ТО
      "regnum": "С8***МУ**", // Регистрационный номер на период ТО
      "vin": "VF34C*****5170236", // VIN код ТС
      "numeaisto": "09997*****21273", // Номер ЕАИСТО
      "marka": "Peugeot", // Марка ТС
      "model": "308", // Модель ТС
      "category": "B:M1", // Категория ТС
      "todate": "15.10.2020", // Период начала (если действующая ДК)
      "todo": "16.10.2021", // Период окончания (если действующая ДК)
      "expert": "Су***ов Игорь Николаевич", // Эксперт
      "operator": "Общество с ограниченной ответственностью \"******\"" // Оператор
    },
	// Пример истории диагностических карт
    {
      "date": null,
      "regnum": "С8***МУ**",
      "vin": "VF34C*****5170236",
      "numeaisto": "0810*****01275",
      "marka": "ПЕЖО",
      "model": "308",
      "category": "B:M1",
      "todate": "", // Период начала (если недействующая ДК)
      "todo": "", // Период окончания (если недействующая ДК)
      "expert": "С*****н Алексей Николаевич", // Эксперт
      "operator": "Е*****ва Оксана Михайловна" // Оператор
    }
  ]
}

Поиск не дал результатов, либо ресурс не вернул ответа за отведенный промежуток времени

{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

История изменений

дата	что изменилось
17.04.2021	Модуль eaisto (проверка диагностических карт) теперь доступен в модуле gibdd, как type=eaisto

Возможные коды ошибок

код (error)	Описание ошибки (message)
000	Модуль eaisto не поддерживается. Воспользуйтесь модулем gibdd, тип eaisto
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
15	DATE_ERROR Ошибка значения переданной даты
5	TEST_TIME_OFF Закончился период тестирования
3	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
2	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
1	API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}