API BigAutoData (v5)

BigAutoData собирает сведения о транспортных средствах, их владельцах, физических лицах и организациях из государственных реестров и коммерческих источников и отдаёт их одним API.

На нём работают автозаполнение анкет по VIN или госномеру, история и характеристики ТС, ДТП и регистрационные действия, штрафы и задолженности, полисы ОСАГО, лицензии такси, отзывные кампании и проверка благонадёжности физических лиц и контрагентов.

Каждая проверка — отдельный продукт со своей тарификацией и своим разделом в этой доке. Разделы слева — по продуктам.

Авторизация — заголовок Authorization: Basic {{TOKEN}} в каждом запросе.

Доступ к продуктам предоставляется по запросу: за подключением и ключами обращайтесь к вашему менеджеру.

Успешный ответ приходит в конверте response: id — идентификатор запроса, cost — стоимость, method — наименование метода, request — эхо параметров, is_error и is_completed — флаги обработки, result — сам результат.

Отсутствие данных — это результат проверки, а не ошибка, и такой ответ тарифицируется. Отличия отдельных продуктов описаны в их разделах.

Когда проверка не выполнена, в result приходит объект с error_code и message.

Значения в пути, записанные кириллицей — госномер, серия документа — передаются в URL-кодировке: А013АА77 → %D0%90013%D0%90%D0%9057.

Большинство методов синхронные: ответ с результатом приходит сразу на GET или POST.

Часть продуктов работает асинхронно: POST создаёт задачу и возвращает task_id, а GET получает результат по task_id. Пока is_completed = false, результат ещё собирается — запрос нужно повторить. Асинхронные разделы: «Штрафы по документам», «Штрафы ФССП», «Регистрации, ограничения, угон», «Проверка благонадёжности», «Водительское удостоверение».

Примеры ответов повторяют структуру реальных ответов API. Значения в них обезличены: VIN, госномера, номера документов и постановлений, реквизиты, адреса, ФИО и названия организаций заменены вымышленными.

Для работы с BigAutoData API поддерживается авторизация через Basic Auth.

Каждый запрос должен содержать заголовок Authorization с токеном, сформированным по схеме Basic.

Возьмите логин и пароль, которые выдал ваш менеджер:

login: user@example.com
password: {{PASSWORD}}

Объедините их в формате login:password:

user@example.com:{{PASSWORD}}

Закодируйте строку в Base64 — результат и есть токен {{TOKEN}}:

echo -n 'user@example.com:{{PASSWORD}}' | base64

Добавьте токен в заголовок запроса:

Authorization: Basic {{TOKEN}}

Ответ приходит без общего конверта — плоским объектом с полем message.

• При использовании Basic Auth токен постоянный и не требует обновления.
• Данные (логин и пароль) должны храниться в защищённом месте.
• Заголовок Authorization обязателен для всех запросов к сервисам BigAutoData API.

Расход и остаток лимитов по каждому продукту за текущий расчётный период: сколько запросов уже сделано, безлимитный продукт или нет, какой лимит и сколько осталось.

Ответ приходит по тому аккаунту, чьим токеном подписан запрос, — параметры передавать не нужно.

Метод синхронный: GET сразу возвращает результат.

Характеристики транспортного средства по VIN, ГРЗ, номеру кузова или номеру шасси: марка, модель, год выпуска, двигатель, масса, цвет, данные СТС и ПТС.

Пять методов отличаются объёмом ответа — от кратких технических характеристик до расширенного отчёта, в котором к характеристикам добавлены ДТП, штрафы, регистрационные действия, ограничения, розыск и лицензия такси. Что именно отдаёт каждый метод — в сравнительной таблице ниже.

Все методы синхронные: ответ приходит сразу.

Базовые характеристики — категория, марка, модель, год выпуска, мощность двигателя в л.с., масса и максимальная разрешённая масса, ГРЗ, VIN, номера кузова и шасси.

Расширенные характеристики — модификация, цвет, количество дверей и сидений, тип привода, объём и тип двигателя, мощность в кВт, расположение руля, а также марка, модель и модификация по нормализованному справочнику.

Если ТС ещё не поставлено на учёт. У такой машины нет госномера, и по обычному поиску она не находится. В этом случае подключается отдельный поиск: характеристики ТС в ответе будут, а поле с госномером останется пустым.