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

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

    $data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.
История изменений/обновлений API
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа
type (Метод) Описание Параметры в запросе
В одном запросе возможно отправить только 1 тип
chekmodel Вывод существующих моделей авто Обязательные
marka - Марка автомобиля
Acura, Alfa Romeo, Aston Martin, Audi, Bentley, BMW, Brilliance, Buick, BYD, Cadillac, Changan, Chery, Chevrolet, Chrysler, Citroen, Dacia, Daewoo, Daihatsu, Datsun, Derways, Dodge, DongFeng, DS, FAW, Ferrari, Fiat, Ford, Foton, GAZ, Geely, Genesis, GMC, Great Wall, Hafei, Haima, Haval, Hawtai, Honda, Hummer, Hyundai, Infiniti, Isuzu, Izh, JAC, Jaguar, Jeep, JMC, Kia, LADA, Lamborghini, Lancia, Land Rover, Lexus, Lifan, Lincoln, Luxgen, Maserati, Maybach, Mazda, Mercedes-Benz, MG, MINI, Mitsubishi, Nissan, Opel, Peugeot, Pontiac, Porsche, Ravon, Renault, Rolls-Royce, Rover, Saab, Saturn, Scion, SEAT, Skoda, Smart, SsangYong, Subaru, Suzuki, TagAZ, TATA, Tesla, Toyota, UAZ, Volkswagen, Volvo, Vortex, Xin Kai, ZAZ, Zotye, ZX
Разрешено: кириллица, латиница, цифры, знак "-"
token - персональный ключ API
chekyear Вывод годов выпуска авто Обязательные
marka - Марка автомобиля
Разрешено: кириллица, латиница, цифры, знак "-"
model - Модель автомобиля (Из предварительного запроса по type=chekmodel)
Разрешено: кириллица, латиница, цифры, знак "-"
token - персональный ключ API
chekgeneration Вывод поколений и модицикациях авто Обязательные
marka - Марка автомобиля
Разрешено: кириллица, латиница, цифры, знак "-"
model - Модель автомобиля (Из предварительного запроса по type=chekmodel)
Разрешено: кириллица, латиница, цифры, знак "-"
year - Год выпуска автомобиля (Из предварительного запроса по type=chekyear)
Разрешено: цифры, знак "-"
token - персональный ключ API
chekbody Вывод кузова и уровня оснащения Обязательные
marka - Марка автомобиля
Разрешено: кириллица, латиница, цифры, знак "-"
model - Модель автомобиля (Из предварительного запроса по type=chekmodel)
Разрешено: кириллица, латиница, цифры, знак "-"
year - Год выпуска автомобиля (Из предварительного запроса по type=chekyear)
Разрешено: цифры, знак "-"
generation - Поколение автомобиля (Из предварительного запроса по type=chekgeneration)
Разрешено: цифры, знак "-"
modification - Модицикация автомобиля (Из предварительного запроса по type=chekgeneration)
Разрешено: цифры, знак "-"
token - персональный ключ API
price Приблизительная оценочная стоимость автомобиля Обязательные
marka - Марка автомобиля
Разрешено: кириллица, латиница, цифры, знак "-"
model - Модель автомобиля (Из предварительного запроса по type=chekmodel)
Разрешено: кириллица, латиница, цифры, знак "-"
year - Год выпуска автомобиля (Из предварительного запроса по type=chekyear)
Разрешено: цифры, знак "-"
probeg - Пробег авто
Разрешено: цифры, знак "-"
Не обязательные, но плиближающие к реальной стоимости
generation - Поколение автомобиля (Из предварительного запроса по type=chekgeneration)
Разрешено: цифры, знак "-"
modification - Модицикация автомобиля (Из предварительного запроса по type=chekgeneration)
Разрешено: цифры, знак "-"
body - Кузов (Из предварительного запроса по type=chekbody)
Разрешено: цифры, знак "-"
equipments - Модицикация автомобиля (Из предварительного запроса по type=chekbody)
Разрешено: цифры, знак "-"
token - персональный ключ API
Примеры запросов

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

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

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

Устранение ошибок
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
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"}