HTTPS GET запрос: https://api-cloud.ru/api/vindecoder.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| vin | Расшифровка данных по VIN номеру ТС
|
Обязательные vin - VIN номер транспортного средства Разрешено: латиница, цифры, знак "-" token - персональный ключ API Дополнительные logo=1 - Загружать лого бренда |
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/vindecoder.php?' . http_build_query($data);
$data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
https://api-cloud.ru/api/vindecoder.php?type=vin&vin=WBA3R11040KS91420&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // true - есть результаты / false - нет
"countReports": 1, // Количество найденных декодировний, их может быть несколько, массив "reports"
// Информация о VIN
"vin": {
"income": "XTA111960A0109992", // Входящий VIN
"normal": "XTA111960A0109992" // Нормализованный VIN
},
// Массив расшифровок, их может быть несколько
"reports": [
{
"basicParams": "LADA Kalina 1.6 16V, 2010", // Основные данные авто (марка, модель, модификация, модельный год)
"powerParams": "1.6{l} 97.89{PS} Euro 3", // данные об объёме, мощности и экологичесих характеристиках двигателя;
"brand": "LADA", // Бренд
"model": "Kalina", // Модель
// Тип кузова
"body": "HBK",
// SDN - Седан
// HBK - Хэтчбек
// LBK - Лифтбек
// WGN - 5-дверный хэтчбек
// MVN - Минивэн
// CUP - Купе
// SAC - на уточнении
// BUS - это, как правило, кузов микроавтобуса, фургона или минивэна, характеризующийся однообъемной компоновкой, где салон для пассажиров и водителя объединен с грузовым отсеком, создавая простор для перевозки людей (обычно более 8 мест) и/или груза, с применением каркасной конструкции и облегченных материалов, как сталь и алюминий
// PCU - на уточнении
// CNV - на уточнении
// FBK - на уточнении
// VAN - фургон
// LNG - на уточнении
// EVN - на уточнении
// MBS - на уточнении
// TTR - на уточнении
// LWG - на уточнении
// HCW - на уточнении
"bodyName": "1119", //
"modelYear": 2010, // Модельный год. Могут быть неточности в случае, когда VIN отсутствует в каталоге производителя, то применяется система декодирования года из VIN номера. Так же год может отсутствовать вовсе, если VIN отсутствует в каталоге производителя и декодировать год из VIN невозможно.
"startYear": "2007", // Год старта производства
"finishYear": "2012", // Год окончания производства (curr - производится по сегодняшний день)
"market": null, // Рынок сбыта (RU / EU / ex.NA / ex.KOR / NA / null)
"steering": null, // Положение руля
"generation": "I", // Поколение
"engineEmission": "Euro 3", // Экологический класс
"doors": 5, // Количество дверей
"modification": "1.6 16V", // Модификация
"engineSeries": "ВАЗ-21126", // Серия двигателя
// Коробка передач
"gear": {
"type": null, // Тип коробки передач
// AUT - Автоматическая КПП
// MAN - Механическая КПП
"speeds": null // Количество передач
},
// Тип привода
"drive": "FWD",
// FWD - Передний привод
// 4WD - Жесткий, подключаемый вручную полный привод с раздаткой и понижающей передачей
// AWD - автоматический или постоянный полный привод для легковых авто и кроссоверов, который электроника сама распределяет между осями для лучшего сцепления на скользких дорогах
// Объём двигателя
"engineVolume": {
"l": 1.6, // объём двигателя в литрах
"ccm": 1596, // объём двигателя в см3
"ci": 97.4 // объём двигателя в куб.дюймах
},
// Мощность двигателя
"enginePower": {
"kW": 72, // номинальная (максимальная) мощность двигателя в килоВаттах
"PS": 97.89, // номинальная (максимальная) мощность двигателя в лошадиных силах (используется в России и Европе)
"hp": 96.55, // номинальная (максимальная) мощность двигателя/электромотора в британских лошадиных силах
// Пределы максимальной мощности. В случае, если элемент min содержит значение, а элемент max содержит null, то это означает, что номинальная (максимальная) мощность достигается не в диапазоне, а при одном значении скорости вращения коленвала.
"range": {
"min": 5600,
"max": null
}
},
// Крутящий момент двигателя
"engineTorque": {
"Nm": 145, // максимальный крутящий момент двигателя в Ньютон-метрах (Н·м)
"kgm": 14.79, // максимальный крутящий момент двигателя в килограм-сила-метрах (кгс·м)
"ftlb": 106.95, // максимальный крутящий момент двигателя/электромотора в фут-силах (ft·lb)
// Пределы крутящего момента. В случае, если элемент min содержит значение, а элемент max содержит null, то это означает, что максимальный крутящий момент достигается не в диапазоне, а при одном значении скорости вращения коленвала.
engineDescription
"range": {
"min": 4000,
"max": null
}
},
// Мощность электродвигателя (в случае электродвигателя, структура аналогична enginePower)
"motPower": [],
// Крутящий момент электродвигателя (в случае электродвигателя, структура аналогична engineTorque)
"motTorque": [],
// Массив Типы топлива. В большинстве случаев содержит одно значение. Для гибридов и мультитопливных твигателей может содержать несколько.
"fuelType": [
"PO"
],
"lineup": "L4", // Компоновка двигателя
"valves": 16, // Количество клапанов
"compression": 16, // Степень сжатия
"camshafts": "DOHC", // Тип привода ГРМ Стандарт определения мощности и момента
"measureStandard": "ГОСТ", // Стандарт определения мощности и момента
"supplySystem": "MPI", // Тип впрыска
"engineFuelrate": "7.2", // Расход топлива
"intercooler": null, // Наличие и тип наддува
// Массив Рыночный сегмент, в котором находится данная модель
// названия классов в соотвествии с классификацией, принятой в различных странах и организациях. Соответствие между ними есть не всегда.
"segment": {
"american": "Economy car",
"british": "Supermini",
"australian": "Light car",
"russian": "Малый класс",
"european": "small cars",
"european_ID": "B",
"euroNCAP": "Supermini",
"EU_EPA": "Subcompact"
},
"ecoParams": null,
// Если в запросе передан параметр logo=1
"urlLogo": "https://api-cloud.ru/api/carPhoto/278a203a65f122e475da.png" // Временная ссылка на лого, жизнь ссылки - 10 минут
}
],
"inquiry": {
"price": 0,
"balance": 1289.69,
"credit": 20000,
"speed": 2,
"attempts": 1
}
}
{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Что делать в такоем случае? Повторите запрос.
| дата | что изменилось |
|---|
| код (error) | Описание ошибки (message) |
|---|---|
| 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 |
| 501 | MISSING_REQUIRED_VIN_PARAMETER Отсутствует параметр vin или указан неверно |
| 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"}