Автотека API для разработчиков
Подключаете свой сервис → получаете токен → покупаете пакет отчётов по договорной цене → дергаете REST API. VIN, госномер или ссылка с Авито — готовый отчёт в JSON.
pv_live_…. Один ключ — одна цена и свой баланс.🧭 Как начать
- Напишите нам в Telegram @suver77 или через форму контактов — договоримся о цене за отчёт.
- Получите API-ключ — пришлём токен
pv_live_…один раз. Сохраните его. - Пополните баланс — формой ниже или методом
POST /api/v1/topup. - Заказывайте отчёты —
POST /api/v1/reportsс VIN / номером / ссылкой Авито.
💳 Пополнить баланс
Вставьте свой API-ключ и число отчётов. Сумма = количество × ваша договорная цена. Оплата через ЮKassa.
📚 Документация API
Базовый URL: https://proverka-vin.ru/api
Авторизация: заголовок Authorization: Bearer pv_live_… или X-Api-Key.
GET /v1/me
Кто вы, цена за отчёт, баланс.
curl -s https://proverka-vin.ru/api/v1/me \ -H "Authorization: Bearer pv_live_YOUR_TOKEN"
GET /v1/balance
curl -s https://proverka-vin.ru/api/v1/balance \ -H "Authorization: Bearer pv_live_YOUR_TOKEN"
POST /v1/reports
Создать отчёт. Тело: {"query":"XTA…"} — VIN, госномер или URL Авито.
curl -s -X POST https://proverka-vin.ru/api/v1/reports \
-H "Authorization: Bearer pv_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"XTA210990Y2450977"}'
Ответ 202:
{
"ok": true,
"report": {
"id": "uuid…",
"status": "processing",
"pollUrl": "https://proverka-vin.ru/api/v1/reports/uuid…"
},
"creditsLeft": 49
}
GET /v1/reports/{id}
Статус: processing → delivered (поле reportUrl) или failed (кредит возвращается).
curl -s https://proverka-vin.ru/api/v1/reports/REPORT_UUID \ -H "Authorization: Bearer pv_live_YOUR_TOKEN"
POST /v1/topup
curl -s -X POST https://proverka-vin.ru/api/v1/topup \
-H "Authorization: Bearer pv_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"count":50}'
В ответе paymentUrl — ссылка на оплату ЮKassa. После оплаты баланс пополнится автоматически.
🤖 В Telegram-боте
Команда /developers или /api — краткая справка, ссылка сюда и баланс (если ключ привязан к вашему Telegram).
❓ FAQ
- Какая цена? Договорная. Фиксируется на вашем ключе в админке.
- Что если отчёт не собрался? Статус
failed— 1 отчёт возвращается на баланс. - Auto.ru? Пока только VIN / госномер / Авито. Auto.ru — вручную через поддержку.
- Лимиты? До 30 запросов отчётов в минуту на ключ.