HTTPS GET запрос: https://api-cloud.ru/api/vindecoder.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| vin | Расшифровка данных по VIN номеру ТС
• Марка
• Модель
• Год
• Тип кузова
• Тип двигателя
• Тип топлива
• Тип трансмиссии
• Класс авто
• Тип авто
• Произведено в
• Отличие кузова
• Количество дверей
• Количество мест
• Рабочий объем двигателя
• Объем двигателя
• Количество клапанов
• Количество цилиндров
• Мощность л.с.
• Мощность двигателя кВт
• Стандарт выбросов
• Трансмиссия
• ABS
• Логотип марки авто
• VIS идентификатор
• VDS
• Идентификатор года
• Серийный номер
|
Обязательные vin - VIN номер транспортного средства Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
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 не найдено
"VIN": {
"title": "VIN",
"value": "SJNFAAJ10Z1229675"
},
"WMI": {
"title": "WMI",
"value": "SJN"
},
"VIS identifier": {
"title": "VIS идентификатор",
"value": "N/A"
},
"VDS": {
"title": "VDS",
"value": "FAAJ10Z1"
},
"Year_identifier": {
"title": "Идентификатор года",
"value": "Z"
},
"Serial_number": {
"title": "Серийный номер",
"value": "229675"
},
"VIN_type": {
"title": "Тип VIN",
"value": "normal"
},
"Make": {
"title": "Марка",
"value": "Nissan"
},
"Model": {
"title": "Модель",
"value": "Qashqai"
},
"Year": {
"title": "Год",
"value": "2008"
},
"Body": {
"title": "Тип кузова",
"value": "5 Doors 5h/b"
},
"Engine": {
"title": "Тип двигателя",
"value": "L4"
},
"Fuel": {
"title": "Тип топлива",
"value": "Бензин"
},
"Transmission": {
"title": "Тип трансмиссии",
"value": "5-Speed Manual"
},
"classCar": {
"title": "Класс авто",
"value": "Компактный внедорожник"
},
"typeCar": {
"title": "Тип авто",
"value": "Внедорожник"
},
"Manufactured": {
"title": "Произведено в",
"value": "United Kingdom"
},
"Body_type": {
"title": "Отличие кузова",
"value": "5h/b"
},
"Number_doors": {
"title": "Количество дверей",
"value": "5"
},
"Number_seats": {
"title": "Количество мест",
"value": "5"
},
"Displacement": {
"title": "Рабочий объем двигателя",
"value": "1598"
},
"Displacement_nominal": {
"title": "Объем двигателя",
"value": "1.6"
},
"Engine_valves": {
"title": "Количество клапанов",
"value": "16"
},
"cylinders": {
"title": "Количество цилиндров",
"value": "4"
},
"gearbox": {
"title": "Механическая коробка передач",
"value": "5MT"
},
"HorsePower": {
"title": "Мощность л.с.",
"value": "94-126"
},
"KiloWatts": {
"title": "Мощность двигателя кВт",
"value": "69-93"
},
"Emission_standard": {
"title": "Стандарт выбросов",
"value": null
},
"Driveline": {
"title": "Трансмиссия",
"value": "2 WHEEL DRIVE"
},
"ABS": {
"title": "ABS",
"value": null
},
"Manufacturer": {
"title": "Производитель",
"value": "Audi AG"
},
"Adress1": {
"title": "Адрес 1",
"value": "Felix Wankel Strasse"
},
"Adress2": {
"title": "Адрес 2",
"value": "74148 Neckarsulm"
},
"Region": {
"title": "Регион",
"value": "Europe"
},
"Country": {
"title": "Страна",
"value": "Germany"
},
"Note": {
"title": "Примечание",
"value": "Manufacturer builds more than 500 vehicles per year"
},
"Standard_equipment": {
"title": "Стандартное оборудование",
"value": [
"Fog lights",
"Power door locks",
"Front air conditioning",
"ABS brakes"
]
},
"Optional_equipment": {
"title": "Дополнительное оборудование",
"value": [
"Traction control",
"Stability control",
"Trip computer",
"Vehicle anti-theft",
"AM/FM radio",
"Power Steering",
"Power windows",
"Heated seats",
"Alloy wheels"
]
},
"logo": {
"title": "Изображение логотипа в base64",
"value": "data:image/png;base64,/9j/4AAQSkZJRgABAQEASABIAAD//gA8Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2ODApLCBxdWFsaXR5ID0gMTAwCv/bAEMAAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAf/bAEMBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEuNV8YkiaVX1/F//IhyLu/w/wAj7VqSwoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKACgAoAKAP/9k="
},
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Что делать в такоем случае? Повторите запрос.
| дата | что изменилось |
|---|---|
| 13.03.2024 | Восстановлена работа. |
| 10.10.2023 | Работа API временно приостановлена. |
| 27.11.2022 | 1. В ответе добавили ключ found, который отвечает за поиск. true - найдено, false - не найдено. |
| 12.11.2022 | В успешном ответе добавлено свойство status => 200 |
| 23.10.2022 | В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. |
| 11.03.2022 | Добавили дополнительные значения в выводе: |
| 10.03.2022 | Исправлены мелкие баги. API стал более стабильней. |
| 18.11.2021 | Информация о запросе в массиве inquiry |
| код (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"}