MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Національного судового реєстру (KRS). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉 Державні реєстри API
Цей посібник стосується API для пошукової системи суб’єктів KRS, яку ми надаємо в рамках продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів
Нижче ми описали, як за допомогою API можна завантажити актуальний список членів правління вказаного суб’єкта господарювання на основі його номера 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]
}
]
}
Актуальний список членів правління організації можна знайти в полі: content.current_excerpt.dane.dzial2.reprezentacja.sklad
Кожен елемент списку, розміщеного в цьому полі, містить дані про окрему особу, яка обіймає певну посаду в представницькому органі суб’єкта.
Приклад вмісту елемента списку content.current_excerpt.dane.dzial2.reprezentacja.sklad:
{
"nazwisko": {
"nazwiskoICzlon": [pierwszy człon nazwiska],
"nazwiskoIICzlon": [drugi człon nazwiska]
},
"imiona": {
"imie": [imię]
},
"identyfikator": {
"pesel": [numer PESEL]
},
"funkcjaWOrganie": [nazwa pełnionej funkcji],
"czyZawieszona": [czy osoba została zawieszona w czynnościach]
}
Дізнайтеся більше:
👉 Структура даних у моделі pl-krs-wp-record
👉 Документація щодо кінцевих точок для моделі pl-krs-wp-record
