Судові справи компанії на JavaScript: fetch, ролі сторін, 429
Оновлено 26.09.2026
Сервіс перевірки контрагентів, внутрішня панель відділу продажів чи кабінет юриста часто мають блок «Судові справи». Людина вводить код ЄДРПОУ і за секунду бачить, скільки справ у компанії, у якій ролі вона в них виступає і коли було останнє рішення. Initask API повертає ці дані запитом `GET https://dani.initask.com/v1/company/{edrpou}/court-cases`. Нижче приклад на JavaScript і поради, як зробити з відповіді зрозумілий блок інтерфейсу.
Приклад
```javascript const r = await fetch("https://dani.initask.com/v1/company/36264680/court-cases", { headers: { Authorization: `Bearer ${process.env.INITASK_KEY}` }, }); const { ok, data, error } = await r.json(); console.log(r.headers.get("X-RateLimit-Remaining"), data); ```
Приклад виконується на сервері: ключ читається зі змінної середовища. Браузер отримує вже оброблені дані від вашого сервера, і ключ Initask API у код сторінки не потрапляє.
Що приходить
Для коду 36264680 у даних назва ТОВ «ТС ПЛЮС», загальна кількість справ і перелік справ, найсвіжіші першими. Єдина справа в прикладі має номер 910/11846/26, розглядається Господарським судом міста Києва, категорія «Справи наказного провадження», останнє рішення 2026-09-21, роль компанії «позивач або заявник», і є посилання на сторінку справи.
Блок в інтерфейсі
Зведення зверху
Людині спершу потрібна коротка відповідь: скільки справ і наскільки вони свіжі. Покажіть загальну кількість з поля `total` і дату найсвіжішого рішення з першої справи в переліку. Під ними розкладку за ролями: скільки разів компанія позивач або заявник, скільки відповідач або боржник, скільки третя особа.
Перелік справ
Далі перелік: номер справи, суд, категорія, дата і роль. Кожен рядок веде за посиланням на сторінку справи, де можна відкрити тексти рішень. Роль варто виділяти кольором, бо саме вона найбільше говорить про ризик.
Порожня історія
Для компанії без справ API відповідає кодом 200, `total: 0`, порожнім переліком і назвою, що дорівнює null. Інтерфейс має показати це як результат перевірки: «Судових справ не знайдено». Порожній блок без тексту люди часто сприймають як збій.
Фільтр за роллю і датою
Для компаній з великою кількістю справ перелік стає довгим. Корисно дати людині фільтри: лише справи, де компанія відповідач або боржник, лише справи за останній рік. Обидва фільтри працюють на вашому боці за полями ролі і дати, без додаткових запитів до API. Юрист, який готує висновок про контрагента, зазвичай дивиться саме ці справи першими.
Код ЄДРПОУ у полі введення
Код юридичної особи має 8 цифр. Коротший код шлюз доповнює нулями зліва, тому людина може не вводити нулі на початку. Якщо в полі є сторонні символи або більше 8 знаків, API поверне 400. Краще перевірити це в полі до запиту і показати підказку одразу.
Ліміти і 429
У кожній відповіді є заголовки лімітів з залишком і моментом скидання. Після вичерпання ліміту приходить код 429 і заголовок `Retry-After`. Для інтерфейсу правильна реакція: показати людині, що перевірка тимчасово недоступна, і запропонувати повторити через вказаний час. Сервер при цьому не повинен засипати API повторними запитами.
Відповідь кешується шлюзом на 60 хвилин. Якщо кілька людей у компанії перевіряють того самого контрагента, повторні запити протягом години ліміт не витрачають. На своєму сервері можна кешувати ще довше.
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Джерело даних
Справи беруться з відкритих даних Єдиного державного реєстру судових рішень, які публікує Державна судова адміністрація. Сервіс sud.initask.com звʼязує сторони рішень з кодами ЄДРПОУ. Під блоком в інтерфейсі варто вказати джерело: людям, які ухвалюють рішення про договір, важливо знати, звідки інформація.
Що робити
- Перенесіть запит на сервер і віддавайте інтерфейсу зведення і перелік справ.
- Покажіть розкладку справ за ролями і дату найсвіжішого рішення.
- Для порожньої історії виводьте явне повідомлення про результат перевірки.
- Поруч розмістіть блоки з картки компанії за ЄДРПОУ і API тендерів.
- Опис полів у документації судових справ, тарифи на сторінці Ціни і ліміти.
Питання і відповіді
Як отримати судові справи компанії через fetch?
Запит fetch з сервера до https://dani.initask.com/v1/company/{edrpou}/court-cases з ключем у заголовку Authorization повертає total і перелік справ з номером, судом, категорією, датою і роллю.
Як показати компанію без судових справ?
API повертає 200 з total: 0 і порожнім переліком. Інтерфейс має показати явне повідомлення «Судових справ не знайдено».
Що робити з кодом 429?
Показати людині, що перевірка тимчасово недоступна, і повторити запит через час із заголовка Retry-After.