MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Національного судового реєстру (KRS). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉 Державні реєстри API
Цей посібник стосується API для пошукової системи суб’єктів KRS, яку ми надаємо в рамках продукту:
👉 API Національного судового реєстру (KRS API) — Пошукова система суб’єктів
Нижче ми описали, як за допомогою API можна знайти суб’єктів з реєстру KRS, пов’язаних із вказаною особою, на підставі її номера PESEL.
Крок 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
Для отримання даних суб’єктів з КРС, пов’язаних із цією особою, необхідно вказати в параметрі identifiers.pl_pesel.full номер PESEL цієї особи.
Приклад виклику ендпойнту Get Records із номером PESEL:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_pesel.full=[номер PESEL] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]
Якщо вас цікавлять лише суб’єкти, з якими вказана особа наразі має якісь ділові відносини, ви також можете скористатися параметром identifiers.pl_pesel.current.
Крок 3: Зчитайте з відповідей дані суб’єктів
При правильному виклику кінцевої точки Get Records у відповідь повертається список записів, що відповідають заданим критеріям.
У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один або кілька записів:
{
"count": [liczba wyników],
"pages": [liczba stron wyników],
"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]
},
...
]
}
Кожен елемент списку результатів містить запис із даними про окремого суб’єкта, зареєстрованого в КРС, з яким особа із вказаним номером PESEL пов’язана або була пов’язана в минулому.
З нього ви можете дізнатися всю інформацію, що міститься в актуальній або повній копії даних про цей суб’єкт.
Дізнайтеся більше:
👉 Структура даних у моделі pl-krs-wp-record
👉 Документація щодо кінцевих точок для моделі pl-krs-wp-record
