РусскийОтчёты об истории автомобиля
Carfax и AutoCheck по VIN, по запросу.
Бесплатно проверьте, сколько записей есть у каждого провайдера по VIN, и запрашивайте полный отчёт, только когда это того стоит. Вы получаете ссылку на HTML-отчёт, при необходимости PDF и баланс после списания.
GET /reports/{type}/{vin}- html
- base64
- balance_after
Как это работает
- 1
Проверьте записи (бесплатно)
Вызовите
/reports/check-records/{vin}.Он возвращает количество записей Carfax и AutoCheck и название автомобиля. Ничего не списывается. - 2
Запросите отчёт (платно)
Вызовите
/reports/{type}/{vin}с type carfax или autocheck. Стоимость одного отчёта списывается с вашего баланса в USD. - 3
Используйте результат
Откройте ссылку html, добавьте pdf=1, если нужен PDF-файл, и читайте
balance_after, чтобы знать остаток.
Проверьте VIN сейчас
Бесплатно: только подсчёт записей.
GET /reports/check-records/{vin}Бесплатный тестовый VIN
Используйте этот VIN, чтобы попробовать оба шага. Отчёты по нему бесплатны.
Оплата
- Отчёты оплачиваются с одного баланса в USD, общего с Pay per VIN. Его показывает
/reports/balance. - check-records, balance и my-history бесплатны.
- С days=N отчёт, который вы уже создавали за последние N дней, возвращается повторно, без создания нового.
- Если баланса не хватает, API отвечает 402 с insufficient funds и ничего не списывает.
- Если у провайдера нет истории по VIN, API отвечает 400 с records not found for this vin number и ничего не списывает.
Справочник API
Полезно знать
- VIN должен содержать ровно 17 символов; иначе вернётся 400.
- pdf=1 может занять от 40 до 60 секунд. Задайте длинный тайм-аут и никогда не отправляйте один и тот же запрос дважды: дубликат получит 409 generation already in progress с Retry-After.
- base64 содержит зашифрованное тело отчёта. Добавьте
exclude_base_64=1,если вам нужны только ссылки. - Значения html и pdf – это ссылки на файлы. Сохраните ссылку или файл у себя.