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)Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
type (Метод) | Описание | Параметры в запросе |
---|---|---|
В одном запросе возможно отправить только 1 тип | ||
vin | Расшифровка данных по VIN номеру ТС
• Марка
• Модель
• Год
• Тип кузова
• Тип двигателя
• Тип топлива
• Тип трансмиссии
• Класс авто
• Тип авто
• Произведено в
• Отличие кузова
• Количество дверей
• Количество мест
• Рабочий объем двигателя
• Объем двигателя
• Количество клапанов
• Количество цилиндров
• Мощность л.с.
• Мощность двигателя кВт
• Стандарт выбросов
• Трансмиссия
• ABS
• Логотип марки авто
• VIS идентификатор
• VDS
• Идентификатор года
• Серийный номер
|
Обязательные vin - VIN номер транспортного средства Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
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, // Баланс после текущего запроса "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, что-то одно. |
015 | DATE_ERROR Ошибка значения переданной даты |
005 | TEST_TIME_OFF Закончился период тестирования |
003 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
002 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
001 | API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}