Автотека API для разработчиков
Подключаете свой сервис → получаете токен → покупаете пакет отчётов по договорной цене через API → дергаете REST. VIN, госномер или ссылка с Авито (Avito Autoteka API) — готовый отчёт в 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 Авито. Списывает 1 кредит Автотеки.
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…",
"product": "autoteka",
"status": "processing",
"pollUrl": "https://proverka-vin.ru/api/v1/reports/uuid…"
},
"creditsLeft": 49
}
POST /v1/reports/json
Структурированный JSON-отчёт (reportjson) — история регистраций, ДТП, залоги, объявления/офферы и связанные блоки. Не Автотека. VIN или госномер. Списывает 1 JSON-кредит.
curl -s -X POST https://proverka-vin.ru/api/v1/reports/json \
-H "Authorization: Bearer pv_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"vin":"XTA210990Y2450977"}'
После delivered в GET /v1/reports/{id} поле data содержит JSON.
GET /v1/reports/{id}
Статус: processing → delivered (Автотека: reportUrl; JSON: data) или 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,"product":"autoteka"}'
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":100,"product":"json"}'
В ответе paymentUrl — ссылка на оплату ЮKassa. После оплаты баланс пополнится автоматически.
Тестовая среда: токен pv_test_… — mock-ответы без списания у поставщиков. Боевой — pv_live_….
🤖 В Telegram-боте
Команда /developers или /api — личный кабинет: балансы Автотека/JSON, email для чеков, пополнение через ЮKassa (если ключ привязан к вашему Telegram).
💰 Цена через API
На ключе две договорные ставки. Типичный партнёрский пилот: Автотека 125 ₽, JSON reportjson 49 ₽. Розничный полный отчёт на сайте — от 149 ₽. Актуальные цены ключа — в GET /v1/me.
❓ FAQ
- Какая цена Автотеки через API? Договорная. Фиксируется на вашем ключе в админке и отдаётся в
/v1/me. - Avito Autoteka API? Да — в
queryпередаёте URL объявления Авито, VIN или госномер. - Что если отчёт не собрался? Статус
failed— 1 отчёт возвращается на баланс. - Auto.ru? Пока только VIN / госномер / Авито. Auto.ru — вручную через поддержку.
- Лимиты? До 30 запросов отчётов в минуту на ключ.
← На главную · Заказать как физлицо · Статья про API · Контакты