УкраїнськаЗвіти про історію авто
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 – це посилання на файли. Збережіть посилання або файл у себе.