API Отзывные компании - API-CLOUD
Документация по работе с API Отзывные компании

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

Старый HTTPS GET запрос до 01.08.2026: https://api-cloud.ru/api/gost.php
Новый HTTPS GET запрос: HTTPS GET запрос: https://api-cloud.ru/api/gost/v2/gost.php

Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
type
Обязательно		 Описание Параметры в запросе
Обязательно
В одном запросе возможно отправить только 1 тип
vin Проверка отзывной компании по VIN коду
• Статус отзывной компании
• Дата отзывной компании
• Организатор
• Марка
• Название ТС
• Причина отзыва
• Рекомендации
• Ссылка на новость об отзывной кампании
 Обязательные
vin - VIN код транспортного средства
Разрешено: латиница, цифры, знак "-"
token - персональный ключ API
certificate Поиск свидетельства о безопасности транспортного средства
• Марка
• Коммерческое наименование
• Тип
• Шасси
• VIN (идентификационный номер)
• Категория
• Год изготовления
• Полная масса
• Тип кузова
• Трансмиссия
• Двигатель
• Тип двигателя
• Экологический класс
• Дата свидетельства
• Номер свидетельства
• Изготовитель
• Адрес изготовителя
• Сборочные заводы и их адреса
• Дополнительная информация
 Обязательные
string - VIN код транспортного средства / Номер свидетельства / Номер шасси
Разрешено: кариллица, латиница, цифры, знаки "- ."
token - персональный ключ 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/gost/v2/gost.php?' . http_build_query($data);

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

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

История изменений API Отзывные компании

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

Запущен новый API (v2):
- Поддержка нескольких отзывных компаний по одному vin (все результаты добавляются в массив result)
- В результате появился ключ passing (статус прохождения отзывной компании)
- Добавлена ключ urlGost (ссылка на новость об отзывной кампании)
- Добавлен ключ found (флаг результат поиска)
- Улучшена обработка
- Обновлена документация
Старый метод будет работать до 01.08.2026. Необходим перевод вашего кода на новую версию, после указанной даты старая версия перестанет работать. 
17.05.2024

Добавили новый метод 'certificate'. Позволяет осуществить поиск свидетельства о безопасности транспортного средства. Подойдет в том случае, когда есть Электронный ПТС и ТС еще не была в ГИБДД, но необходимо знать что за авто. Подробнее в документации
05.01.2023

Пересобран алгоритм работы. API работает в штатном режиме.
23.10.2022

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

Исправлена ошибка в выводе, где поля были перепутаны.
29.04.2022

Исправлена ошибка, при передаче VIN в нижнем регистре отсутствовал результат.
18.11.2021

Информация о запросе в массиве inquiry
Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток
17.04.2021

Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен.
Код ошибки: 999. SERVICE_CAPTCHA_OFFLINE

Возможные коды ошибок

код (error) Описание ошибки (message)
888 ИМЯ передаваемой переменной: forbidden symbols present
В переменной ИМЯ присутствуют запрещенные символы
766 MISSING_MANDATORY_PARAMETER
Отсутствуют обязательные параметры
602 TOKEN_NO_ACCESS
Нет доступа к запрашиваему методу запроса
511 string: forbidden symbols present
В переменной string присутствуют запрещенные символы
510 MISSING_REQUIRED_STRING_PARAMETER
Отсутствует обязательный параметр string
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
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"}