VIN Декодер - API-CLOUD
Документация по работе с API VIN Декодер

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/vindecoder.php с персональным ключом API и параметрами.
Пример отправки 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/vindecoder.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.
История изменений/обновлений API
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа
type (Метод) Описание Параметры в запросе
В одном запросе возможно отправить только 1 тип
vin Расшифровка данных по VIN номеру ТС
• Марка
• Модель
• Год
• Тип кузова
• Тип двигателя
• Тип топлива
• Тип трансмиссии
• Класс авто
• Тип авто
• Произведено в
• Отличие кузова
• Количество дверей
• Количество мест
• Рабочий объем двигателя
• Объем двигателя
• Количество клапанов
• Количество цилиндров
• Мощность л.с.
• Мощность двигателя кВт
• Стандарт выбросов
• Трансмиссия
• ABS
• Логотип марки авто
• VIS идентификатор
• VDS
• Идентификатор года
• Серийный номер
Обязательные
vin - VIN номер транспортного средства
Разрешено: латиница, цифры, знак "-"
token - персональный ключ API
Примеры запросов

История изменений API Расшифровка данных VIN номера

дата что изменилось
13.03.2024

Восстановлена работа.
С 17.03.2024 стоимость 1 запроса будет составлять 0.6 руб / запрос

10.10.2023

Работа API временно приостановлена.
Сообщим о возобновлении работы после того, как найдем нового поставщика данных.

27.11.2022

1. В ответе добавили ключ found, который отвечает за поиск.  true - найдено, false - не найдено.
2. Добавили обработчик не корректного ввода VIN, если vin не корректный, то в результате found будет false

12.11.2022

В успешном ответе добавлено свойство status => 200

23.10.2022

В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. 

11.03.2022

Добавили дополнительные значения в выводе:
1. Manufacturer - производитель
2. Adress1 и Adress2 - адреса производителя
3. Region - регион
4. Country - страна
5. Note - примечание по производителю
6. Standard_equipment - перечень стандартного оборудования
7. Optional_equipment - перечень дополнительного оборудования

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"}