Initask API: відкриті дані України одним JSON-запитом

Картка компанії за ЄДРПОУ, пошук за назвою, тендери Prozorro, судові справи, КВЕД, офіційний курс НБУ на дату, перевірка IBAN, податкові строки, авто за номерним знаком і торговельні марки. Один ключ, один формат відповіді, ліміти в заголовках. Для CRM, облікових програм, інтернет-магазинів і власних скриптів.

Отримати ключ Документація OpenAPI 3.1

Перший запит

Без ключа API відповідає на 100 запитів на добу з однієї адреси, тож приклад можна запустити просто зараз.

curl "https://dani.initask.com/v1/company/00032129"

{
  "ok": true,
  "data": {
    "edrpou": "00032129",
    "name": "АКЦІОНЕРНЕ ТОВАРИСТВО \"ДЕРЖАВНИЙ ОЩАДНИЙ БАНК УКРАЇНИ\"",
    "short_name": "АТ \"ОЩАДБАНК\"",
    "status": "active",
    "status_label": "Зареєстровано",
    "registered": "1991-12-31",
    "capital": "49472840000,00",
    "signers": [
      "КАЦІОН ЮРІЙ МИКОЛАЙОВИЧ - керівник",
      "МАГУЛЄВСЬКА РІТА АНАТОЛІЇВНА ; начальник філії-Запорізького обласного управління АТ \"Ощадбанк\"; 04.04.2012"
    ],
    "url": "https://reestr.initask.com/company/00032129"
  },
  "meta": {
    "source": "reestr.initask.com",
    "cached": false
  }
}

Ендпоінти

Ендпоінт	Що повертає
GET /v1/company/{edrpou}	Компанія за кодом ЄДРПОУ
GET /v1/company/search	Пошук компаній за назвою
GET /v1/company/{edrpou}/tenders	Тендери компанії в Prozorro
GET /v1/kved/{code}	КВЕД за кодом
GET /v1/rates	Офіційний курс НБУ на дату
GET /v1/iban/{iban}	Перевірка IBAN і банк отримувача
GET /v1/deadlines	Податкові строки за роллю і місяцем
GET /v1/company/{edrpou}/court-cases	Судові справи компанії
GET /v1/vehicle/{plate}	Авто за номерним знаком
GET /v1/trademarks/search	Пошук торговельних марок

Ліміти і ціни

Тариф	Запитів	Ціна
Безкоштовний	100 на добу	0 грн
Старт	10 000 на місяць	990 грн / міс
Про	100 000 на місяць	2 990 грн / міс

Передплата Initask Pro на всі сервіси мережі теж відкриває API з лімітом 10 000 запитів на місяць. Усі умови

Формат відповіді

Успіх: {"ok": true, "data": {...}, "meta": {"source": "...", "cached": false}}. Помилка: {"ok": false, "error": "not_found", "message": "...", "docs": "..."} з кодом HTTP 400, 401, 404, 429, 502 або 504. Кожна відповідь несе заголовки X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset.

Отримати ключ API

Ключ прийде листом з каси Initask. Безкоштовний ключ дає 100 запитів на добу, платний тариф додається до того самого ключа.

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

Як отримати ключ API?

Залиште пошту у формі на головній або на сторінці цін: ключ прийде листом з каси Initask. Безкоштовний ключ дає 100 запитів на добу.

Як передати ключ?

Заголовком Authorization: Bearer КЛЮЧ або параметром ?key=КЛЮЧ. Заголовок безпечніший: адреса з параметром лишається в журналах проксі.

Що буде, коли ліміт вичерпано?

Відповідь 429 з заголовком Retry-After: скільки секунд до скидання ліміту. Добовий ліміт скидається опівночі за Києвом, місячний першого числа.

Чи можна викликати API з браузера?

Так, GET-запити відкриті для CORS з будь-якого домену. Ключ у коді сторінки бачить кожен відвідувач, тому платний ключ краще тримати на сервері.