Авто за номером на JavaScript: автозаповнення форми за номерним знаком

Оновлено 26.09.2026

Калькулятор страхового поліса, запис на СТО, форма оголошення про продаж авто: у всіх цих формах людина вводить марку, модель, рік випуску і вид пального. Кожне поле це шанс помилитися або кинути форму. Автозаповнення за номерним знаком скорочує форму до одного поля. Initask API повертає реєстраційні операції з відкритих даних МВС за номером запитом `GET https://dani.initask.com/v1/vehicle/{plate}`. Нижче приклад на JavaScript і те, що варто врахувати в інтерфейсі.

Приклад

```javascript const r = await fetch("https://dani.initask.com/v1/vehicle/AA0005KX", { headers: { Authorization: `Bearer ${process.env.INITASK_KEY}` }, }); const { ok, data, error } = await r.json(); console.log(r.headers.get("X-RateLimit-Remaining"), data); ```

Запит виконує сервер з ключем у змінній середовища. Форма в браузері надсилає номер вашому серверу і отримує у відповідь уже підготовлені значення полів.

Від відповіді до полів форми

Відповідь містить номер латиницею, кількість операцій і перелік операцій за датою. Для автозаповнення потрібна найсвіжіша операція: номерний знак переходить між автомобілями, і після зняття з обліку його видають іншому власнику. Для AA0005KX у 2013-10 номер мав MERCEDES-BENZ S 350, а в 2025-04 операція «перереєстрація на нового власника» стосується TOYOTA CAMRY 2021 року. Форма має взяти саме другу машину.

Після заповнення покажіть людині, що саме підставлено, і дайте змогу виправити. Дані МВС надійні, але людина могла ввести чужий номер з одруком, і тоді підтвердження рятує від неправильного поліса чи запису.

Введення номера

Номер можна вводити латиницею або кирилицею, з пробілами чи без: шлюз передає кирилицю як є, а джерело зводить її до латиниці. Допустима довжина від 4 до 10 літер і цифр. Перевірте довжину в полі до запиту, щоб не витрачати ліміт на явно неправильне введення. Запускайте запит, коли людина завершила введення, наприклад після виходу з поля.

Стани, які має обробити форма

404. Номера немає у відкритих даних. Форма показує звичайні поля марки і моделі для ручного введення, без повідомлення про помилку великими літерами: для людини це просто інший шлях.

400. Рядок не схожий на номерний знак. Підказка під полем: «Перевірте номер: від 4 до 10 літер і цифр».

503 з помилкою upstream_loading. Джерело перезавантажує архів МВС. Заголовок `Retry-After` підкаже, коли спробувати знову. Для людини форма переходить на ручне введення і не змушує чекати.

429. Вичерпано ліміт, заголовок `Retry-After` так само показує час очікування. Реакція форми та сама: ручне введення.

Форма оголошення про продаж

Для сайту оголошень автозаповнення корисне двічі. Продавець заповнює форму швидше, а покупець отримує дані, звірені з реєстром. Історія операцій за номером теж може стати частиною оголошення: скільки разів авто переходило між власниками і в яких регіонах реєструвалось. Покупці довіряють оголошенням з такою історією більше.

Що в даних немає

Відповідь містить характеристики авто і операції. Повного VIN, точних дат, сервісного центру і типу власника у відповіді немає, вони є в платному звіті на avto.initask.com. Імен, адрес і кодів фізичних осіб у відкритому наборі МВС немає. Для форми це означає, що дані власника людина вводить сама, а API заповнює лише характеристики машини.

Кеш і ліміти

Відповідь кешується на 1440 хвилин. Якщо людина повертається до форми або кілька разів змінює інші поля, сервер не повинен повторювати запит за тим самим номером: зберігайте результат у сесії.

Для публічної форми з помітним трафіком безкоштовного ліміту забракне, тому закладіть стартовий план.

Що робити

1. Додайте у форму поле номерного знака першим і перевіряйте довжину до запиту.
2. Заповнюйте марку, модель, рік і пальне з найсвіжішої операції і показуйте підтвердження.
3. Для 404, 503 і 429 переходьте на ручне введення без драматичних повідомлень.
4. Для корпоративних клієнтів з автопарком підтягуйте реквізити з картки за ЄДРПОУ.
5. Опис полів у документації авто за номером, тарифи на сторінці Ціни і ліміти.

Питання і відповіді

Як заповнити марку і модель авто за номерним знаком?

Запит fetch з сервера до https://dani.initask.com/v1/vehicle/{plate} повертає операції за датою. Беріть марку, модель, рік і пальне з найсвіжішої операції.

Що робити, якщо API повернув 503?

Джерело перезавантажує архів МВС. Переведіть форму на ручне введення і повторіть запит через час із заголовка Retry-After.

Чи повертає API дані власника авто?

Ні. Імен, адрес і кодів фізичних осіб у відкритому наборі МВС немає, відповідь містить лише характеристики авто і операції.

Джерела даних

• Документація: Авто за номерним знаком
• Відкриті дані МВС України про реєстраційні операції з транспортними засобами, avto.initask.com