Главная → Документация → Тестовые VIN, госномер и СТС для отладки API

Тестовые VIN, госномер и СТС для отладки API

Тестовые значения для отладки интеграции: VIN X7TEST00000000001, госномер Т000ТТ00, номер кузова TEST-0000001, СТС 0000000000. По ним любой метод API отвечает образцом по своей схеме: бесплатно, без списания и даже при нулевом балансе.

Как подключиться без бесплатных периодов и согласований

1. Регистрация за минуту. В личном кабинете токен выдаётся сразу, без заявок, договоров и звонков менеджера.
2. Интеграция на тестовых значениях. Пишете код, разбираете ответы, отлаживаете ошибки: тестовые VIN, госномер и СТС не стоят ничего.
3. Пополнение и реальные проверки. Деньги списываются только по правилам метода, ошибки бесплатны.

Тестовые значения по методам

Госномер можно передать кириллицей или латиницей, регистр и пробелы не важны. Номер кузова принимается с дефисом и без. Для /ktg-permit тестовым считается госномер, номер разрешения вернётся в ответе как передан.

Что приходит в ответ

Ответ-образец повторяет схему метода из документации: те же поля и типы, вымышленные данные (марка LADA VESTA, тестовые организации и номера). Дополнительно:

• поле "testMode": true в корне ответа;
• заголовок X-Test-Mode: 1;
• блок billing как в боевом ответе, но с "charged": 0 и "billed": false: так можно заранее отладить учёт расходов у себя (о блоке billing);
• запрос не попадает в статистику и счётчики расходов кабинета.

{
  "success": 1,
  "query": {
    "vin": "X7TEST00000000001"
  },
  "found": 1,
  "active_count": 1,
  "records": [ ... ],
  "testMode": true,
  "billing": {
    "charged": 0,
    "currency": "RUB",
    "billed": false,
    "balance": 481,
    "requestId": null
  }
}

Что проверяется как обычно

• Токен: без токена NO_TOKEN, с неверным TOKEN_INVALID.
• Доступ к методу: если метод не подключён токену, придёт NOT_ALLOWED, как и в боевом запросе.
• Белый список IP, если вы его задали в кабинете.
• Не проверяется только баланс: тестовые запросы работают и при нуле.

Асинхронный метод: ДТП по базе ГИБДД

Для /accidents-rt тест повторяет настоящий цикл: первый запрос с vin=X7TEST00000000001 возвращает status: "pending" и taskId: "TEST-TASK-0001", опрос ?task=TEST-TASK-0001 сразу отдаёт status: "done" с результатом. Так проверяется код ожидания задачи.

Пример

curl -s -G "https://api.avtovincod.ru/pledge" \
  --data-urlencode "vin=X7TEST00000000001" \
  -H "Authorization: Bearer $AVC_TOKEN"

Готовые примеры на PHP, Python, JavaScript, Go, Java, C#, Ruby и 1С есть на странице каждого метода в разделе "Примеры кода": они уже настроены на тестовые значения.

Тестовые значения в ИИ-ассистентах

Через MCP-сервер тестовые значения работают так же: попросите ассистента проверить VIN X7TEST00000000001, и он получит ответ-образец без списания.

Частые вопросы

Есть ли у API бесплатный тестовый период?

Нет. Вместо пробного периода есть тестовые значения (VIN X7TEST00000000001, госномер Т000ТТ00, СТС 0000000000): по ним любой метод бесплатно отвечает образцом, чтобы собрать интеграцию. Для проверки реальных машин достаточно пополнить баланс.

Нужно ли согласование или договор, чтобы начать?

Нет. Регистрация в личном кабинете занимает минуту, токен выдаётся сразу. Юрлица могут пополнить по счёту, физлица картой онлайн.

Списываются ли деньги за тестовые запросы?

Нет. Тестовые значения не обращаются к источникам и не тарифицируются, баланс может быть нулевым.

Чем тестовый ответ отличается от настоящего?

Схема та же, данные вымышленные. В ответе есть поле testMode: true и заголовок X-Test-Mode: 1.

Сколько тестовых запросов можно сделать?

До 60 в минуту на токен. Этого хватает для автотестов интеграции.