MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Національного судового реєстру (KRS). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉 Державні реєстри API
Цей посібник стосується API для пошукової системи суб’єктів KRS, яку ми надаємо в рамках продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів
Нижче ми описали, як за допомогою API завантажити актуальну виписку з KRS у форматі PDF для вказаного суб’єкта на підставі його номера KRS.
Крок 1: Отримати ключ авторизації в API
Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів господарювання
Крок 2: Викличте кінцеву точку Get Records
Дані, доступні в пошуковій системі суб’єктів KRS, ми надаємо в MGBI API у вигляді моделі даних з ідентифікатором pl-krs-wp-record.
API надає для цієї моделі кінцеву точку Get Records, яка повертає записи, що містять текст поточного та повного виписки з KRS для суб’єктів, які відповідають вказаним критеріям.
👉 Документація кінцевої точки Get Records для моделі pl-krs-wp-record
Для отримання даних про окремий суб’єкт господарювання з КРС необхідно вказати в ендпойнті Get Records його реєстраційний номер: KRS, NIP або REGON. Приклад виклику ендпойнту Get Records із номером KRS:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_krs=[номер KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]
Крок 3: Знайдіть у відповіді адресу для завантаження файлу
При правильному виклику кінцевої точки Get Records у відповідь повертається список записів, що відповідають заданим критеріям.
У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один запис:
{
"count": 1,
"pages": 1,
"results": [
{
"id": [identyfikator rekordu],
"identifiers": [identyfikatory podmiotu i powiązanych osób],
"content": [treść odpisu aktualnego i pełnego],
"files": [pliki odpisów w formacie PDF],
"relations": [relacje podmiotu z innymi podmiotami i osobami],
"meta": [metadane rekordu]
}
]
}
Адресу PDF-файлу з текстом актуального витягу з КРС для знайденого суб’єкта можна знайти в полі files.current_excerpt_pdf_file.url.
Крок 4: Завантажте вміст файлу та збережіть його або надішліть до браузера
Щоб завантажити вміст файлу з актуальною версією, надішліть запит HTTP GET із адресою, зчитаною з поля files.current_excerpt_pdf_file.url, та ключем авторизації в API:
GET [адреса файлу] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]
Ви також можете відразу надіслати вміст файлу до веб-браузера користувача вашого додатка. У цьому випадку встановіть значення заголовка HTTP Content-Type, що повідомляє браузеру про формат переданого файлу, на основі вмісту поля files.current_excerpt_pdf_file.content_type.
Дізнайтеся більше:
👉 Структура даних у моделі pl-krs-wp-record
👉 Документація щодо кінцевих точок для моделі pl-krs-wp-record
