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

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

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.

История изменений/обновлений API

Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

HTTPS GET запрос: https://api-cloud.ru/api/eaisto/v2/eaisto.php
Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.

type (тип)	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
mileage	Проверка техосмотра и пробега (НЕ КЭШ)	Обязательные string - строка поиска (vin номер, номер кузова или номер шасси) Маска: [A-Za-zА-Яа-я0-9] token - персональный ключ API Дополнительные search - car_vin / car_body / car_chassis car_vin: Поиск по номеру vin (по умолчанию) car_body: Поиск по номеру кузова (по умолчанию) car_chassis: Поиск по номеру шасси (по умолчанию)

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

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

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

Пример отправки GET запроса на PHP:

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/mvd.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.

Примеры запросов

Проверка техосмотра и пробега

https://api-cloud.ru/api/eaisto/v2/eaisto.php?type=mileage&string=XTT21120010022100&token=53ba1b7a55abbB014aa97eff3a522079

{
  "status": 200, // Статус ответа
  // Массив по партнеру
  "partner": {
    "status": 200, // Статус ответа партнера
    "found": true, // Флаг поиска / true = найдено / false = не найдено
  // Массив с реузльтатами ответа партнера
    "result": {
      "brand_model": "BRAND MODEL", // Марка и модель
      "brand": "BRAND", // Марка
      "model": "MODEL", // Модель
      "year": "1970", // Год выпуска
      "vin": "XTT21120010022100", // vin номер
      "body": null, // Номер кузова
      "chassis": null, // Номер шасси
      // Массив с данными дагностических карт
      "dkList": [
        {
          "car_number": "А599АА11", // гос. номер
          "car_vin": "XTT21120010022100", // vin номер
          "car_body": null, // Номер кузова
          "car_chassis": null, // Номер шасси
          "eaisto_dk_number": "277334111111965479742", // Номер диагностической карты
          "eaisto_dk_date_start": 1353873600, // Действие ДК с даты (UNIXTIME)
          "eaisto_dk_date_stop": 1416949200, // Действие ДК до даты (UNIXTIME)
          "eaisto_dk_operator_number": "02388", // Номер оператор
          "eaisto_dk_mileage": 83710, // Пробег
          "eaisto_dk_status": false // Флаг действия ДК / true = действует / false = не действует
        },
        {
          "car_number": "А599АА11",
          "car_vin": "XTT21120010022100",
          "car_body": null,
          "car_chassis": null,
          "eaisto_dk_number": "167911111127711319428",
          "eaisto_dk_date_start": 1353873600,
          "eaisto_dk_date_stop": 1416949200,
          "eaisto_dk_operator_number": "01986",
          "eaisto_dk_mileage": 152800,
          "eaisto_dk_status": false
        }
      ]
    }
  },
  "inquiry": {
    "price": 6,
    "balance": 3755.14,
    "credit": 20000,
    "speed": 0,
    "attempts": 1
  }
}

История изменений API ЕАИСТО

дата	что изменилось
easto-01	parameter search not documented Значение параметра search не задокументировано
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
5	TEST_TIME_OFF Закончился период тестирования
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
3	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
2	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
15	DATE_ERROR Ошибка значения переданной даты
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
1	API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

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

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