Перейти до змісту
VikRail
API та вивантаження

Дані про ваш парк — у ваших системах

Дислокація, рух, ремонти й оберти через REST API або готовим Excel-файлом за розкладом. Без ручного копіювання з таблиць.

POST /api/v1/wagon/dislocation
Authorization: Bearer •••••••••
X-Lang: uk

{"wagons": [52418036]}

200 OK
{
  "success": true,
  "data": [{
    "wagon": 52418036,
    "operation_station_name": "БАЛТА",
    "operation_name": "ОТПР",
    "operation_date": "2026-10-14 13:39:00",
    "cargo_name": "Шрот кормовий",
    "destination_station_name": "ІЗОВ (ЕКСП. ПКП)",
    "number_days_idle": "0.93",
    "realistic_arrival_date": "2026-10-17"
  }]
}

Знайомо?

Що вирішує цей розділ

«Щоранку вручну переносимо дислокацію в облікову систему»

Ваша система сама забирає дислокацію через API — у JSON, з тими самими полями, що й у таблиці.

«Щодня вивантажуємо той самий звіт і розсилаємо колегам»

Розсилка надсилає Excel зі збереженим фільтром на пошту чи в Telegram у заданий час.

«Підряднику потрібні дані, але не весь кабінет»

Окремий акаунт «лише API» без веб-інтерфейсу, з правами лише на потрібні розділи.

«Ставимо вагони на стеження вручну, хоча список уже є в нашій системі»

Постановка на стеження й зняття з нього — тим самим API.

Можливості

Що вміє система

Дислокація

Поточне місце кожного вагона: станція, операція, вантаж, простій, прогноз прибуття. Фільтри за вагонами, станціями, вантажем, групою.

Рух і відправки

Операції по вагонах за період — за датою операції або датою надходження в систему; відповідь посторінково.

Стеження

Поставити список вагонів на стеження, змінити чи закрити дати, отримати перелік вагонів на стеженні.

Ремонти

Поточні ремонти, історія, повторні відчеплення, структура несправностей, втрачені вагонодоби.

Оберти й звіти

Оберти за фазами, простої, помісячне навантаження й вивантаження, пробіги, паспортні дані вагонів.

Акаунт «лише API»

Окремий користувач для інтеграції: входить лише через API, бачить лише дозволені розділи.

Ті самі права, що й у вебі

Розділ, закритий користувачу в браузері, закритий йому й через API.

Excel з будь-якої таблиці

Уся вибірка з фільтром, колонками й підсвіткою, як на екрані; великі файли готуються у фоні.

Звіти за розкладом

Excel на пошту чи в Telegram у заданий час, зокрема «лише нове з попередньої розсилки».

Як це працює

  1. 01

    Отримуєте доступ

    Запит на вхід з логіном і паролем повертає токен; для інтеграції можна завести окремий акаунт «лише API».

  2. 02

    Робите запит

    POST на потрібний розділ з токеном у заголовку й фільтрами в тілі запиту. Мову назв станцій і вантажів задає заголовок X-Lang.

  3. 03

    Отримуєте JSON

    Кожна відповідь — у єдиному форматі: успіх, дані, повідомлення. Помилки — у тому ж форматі з поясненням.

Питання

Часті запитання

У якому форматі дані?

API відповідає в JSON. У веб-інтерфейсі й розсилках — Excel.

Чи є обмеження на кількість запитів?

Так, 60 запитів на хвилину на користувача. Великі вибірки віддаються посторінково.

Де документація?

Документація з прикладами, колекцією Postman і специфікацією OpenAPI відкривається в системі після входу.

З якими системами можна інтегрувати?

З будь-якою, що вміє надсилати HTTP-запити й читати JSON. Готових конекторів до конкретних облікових систем немає — інтеграцію налаштовує ваш розробник за документацією.

Чи можна дати доступ лише підряднику?

Так: окремий акаунт «лише API» з правами лише на потрібні розділи.

Подивіться на своїх задачах

Покажемо, як це працюватиме з вашим парком, і відповімо на запитання.

Замовити демо або зателефонуйте +380 63 378 22 79

Інші можливості

Дислокація й карта

Де кожен вагон зараз: станція, операція, вантаж, скільки стоїть і коли прибуде.

Оберти й простої

Скільки триває оберт, де вагони чекають навантаження й вивантаження, які станції гальмують парк.

Ремонти

Відчеплення й вихід з ремонту, депо, несправності, наближення планового ремонту за датою й пробігом.

Сповіщення й розсилки

Система сама пише в Telegram чи на пошту, коли вагон довго стоїть, потрапив у ремонт або прибув.