NIKO REG API

Огляд API

NIKO REG API надає доступ до бази даних транспортних засобів України. API дозволяє здійснювати пошук по номерному знаку та/або VIN-коду для отримання детальної інформації про транспортний засіб.

Особливості:

• Швидкий пошук за номерним знаком або VIN-кодом
• Кешування запитів для підвищення швидкодії
• Rate limiting: 60 запитів на хвилину
• Автентифікація через Bearer токени
• JSON формат відповідей

Автентифікація

Для доступу до API необхідно використовувати Bearer токен в заголовку Authorization.

Заголовок запиту:

Authorization: Bearer YOUR_TOKEN_HERE
Content-Type: application/json
Accept: application/json

Ендпоінти API

{
  "status": "ok",
  "timestamp": "2025-10-30T12:00:00+00:00"
}

{
  "success": true,
  "data": {
    "brand": "VOLKSWAGEN",
    "model": "GOLF",
    "vin": "WVWZZZ1JZ3W123456",
    "make_year": 2018,
    "color": "СІРИЙ",
    "kind": "ЛЕГКОВИЙ",
    "body": "СЕДАН",
    "purpose": "ЗАГАЛЬНОГО ПРИЗНАЧЕННЯ",
    "fuel": "БЕНЗИН",
    "capacity": 1600,
    "own_weight": 1200,
    "total_weight": 1700,
    "registration_number": "AА1234AA",
    "registration_date": "2018-05-15",
    "operation": {
      "code": "01",
      "name": "РЕЄСТРАЦІЯ"
    },
    "department": {
      "code": "12345",
      "name": "МРЕВ ГУ НП В КИЇВСЬКІЙ ОБЛАСТІ"
    }
  }
}

Приклади використання

# Пошук за номерним знаком
curl -X GET "https://reg.niko.ua/api/v1/vehicle?plate=AA1234AA" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Accept: application/json"

# Пошук за VIN-кодом з детальною інформацією
curl -X GET "https://reg.niko.ua/api/v1/vehicle?vin=WVWZZZ1JZ3W123456&detailed=true" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Accept: application/json"

$token = 'YOUR_TOKEN_HERE';
$plate = 'AA1234AA';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://reg.niko.ua/api/v1/vehicle?plate=" . urlencode($plate));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $token,
    'Accept: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    echo "Знайдено: " . $data['data']['brand'] . " " . $data['data']['model'];
} else {
    echo "Помилка: " . $data['message'];
}

curl_close($ch);

const token = 'YOUR_TOKEN_HERE';
const plate = 'AA1234AA';

fetch(`https://reg.niko.ua/api/v1/vehicle?plate=${encodeURIComponent(plate)}`, {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${token}`,
        'Accept': 'application/json'
    }
})
.then(response => response.json())
.then(data => {
    if (data.success) {
        console.log(`Знайдено: ${data.data.brand} ${data.data.model}`);
    } else {
        console.error(`Помилка: ${data.message}`);
    }
})
.catch(error => {
    console.error('Помилка запиту:', error);
});

import requests

token = 'YOUR_TOKEN_HERE'
headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json'
}

# Пошук за номерним знаком
response = requests.get(
    'https://reg.niko.ua/api/v1/vehicle',
    params={'plate': 'AA1234AA'},
    headers=headers
)

data = response.json()

if data['success']:
    vehicle = data['data']
    print(f"Знайдено: {vehicle['brand']} {vehicle['model']}")
else:
    print(f"Помилка: {data['message']}")

// Функція для пошуку транспортного засобу
Функция НайтиТранспортныйСредство(НомерАвто, ВИНКод = "") Экспорт
    
    // Налаштування запиту
    Токен = "YOUR_TOKEN_HERE";
    БазовыйURL = "https://reg.niko.ua/api/v1/vehicle";
    
    // Створення HTTP запиту
    HTTPЗапрос = Новый HTTPЗапрос();
    HTTPЗапрос.АдресРесурса = БазовыйURL;
    HTTPЗапрос.Заголовки.Вставить("Authorization", "Bearer " + Токен);
    HTTPЗапрос.Заголовки.Вставить("Accept", "application/json");
    HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
    
    // Параметри запиту
    Параметры = Новый Структура;
    Если НЕ ПустаяСтрока(НомерАвто) Тогда
        Параметры.Вставить("plate", НомерАвто);
    КонецЕсли;
    Если НЕ ПустаяСтрока(ВИНКод) Тогда
        Параметры.Вставить("vin", ВИНКод);
    КонецЕсли;
    Параметры.Вставить("detailed", Истина);
    
    // Формування URL з параметрами
    СтрокаПараметров = "";
    Для Каждого Параметр Из Параметры Цикл
        Если НЕ ПустаяСтрока(СтрокаПараметров) Тогда
            СтрокаПараметров = СтрокаПараметров + "&";
        КонецЕсли;
        СтрокаПараметров = СтрокаПараметров + Параметр.Ключ + "=" + КодироватьСтроку(Параметр.Значение, СпособКодированияСтроки.КодировкаURL);
    КонецЦикла;
    
    HTTPЗапрос.АдресРесурса = БазовыйURL + "?" + СтрокаПараметров;
    
    // Виконання запиту
    HTTPСоединение = Новый HTTPСоединение("reg.niko.ua", , , , , 60);
    
    Попытка
        HTTPОтвет = HTTPСоединение.Получить(HTTPЗапрос);
        
        Если HTTPОтвет.КодСостояния = 200 Тогда
            // Парсинг JSON відповіді
            ЧтениеJSON = Новый ЧтениеJSON;
            ЧтениеJSON.УстановитьСтроку(HTTPОтвет.ПолучитьТелоКакСтроку());
            Результат = ПрочитатьJSON(ЧтениеJSON);
            ЧтениеJSON.Закрыть();
            
            Если Результат.success Тогда
                Данные = Результат.data;
                Сообщить("Знайдено: " + Данные.brand + " " + Данные.model + " (" + Данные.make_year + ")");
                Возврат Данные;
            Иначе
                Сообщить("Помилка: " + Результат.message);
                Возврат Неопределено;
            КонецЕсли;
        Иначе
            Сообщить("Помилка HTTP: " + HTTPОтвет.КодСостояния + " " + HTTPОтвет.ПолучитьТелоКакСтроку());
            Возврат Неопределено;
        КонецЕсли;
        
    Исключение
        Сообщить("Помилка виконання запиту: " + ОписаниеОшибки());
        Возврат Неопределено;
    КонецПопытки;
    
КонецФункции

// Приклад використання
НомерАвто = "AA1234AA";
РезультатПошуку = НайтиТранспортныйСредство(НомерАвто);

Если РезультатПошуку <> Неопределено Тогда
    // Обробка отриманих даних
    Марка = РезультатПошуку.brand;
    Модель = РезультатПошуку.model;
    РікВипуску = РезультатПошуку.make_year;
    Колір = РезультатПошуку.color;
    ВИН = РезультатПошуку.vin;
    
    // Тут можна зберегти дані в базу 1С або використати в бізнес-логіці
КонецЕсли;

Коди помилок

Приклад відповіді з помилкою:

{
  "success": false,
  "message": "Vehicle not found",
  "data": null
}

Контакти та підтримка