Як за допомогою API отримати зміст оголошень та записів у KRS, опублікованих у MSIG, щодо вказаного суб’єкта господарювання?

MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема з Судового та економічного монітора (MSIG).

Перелік джерел даних, доступних у цій службі, можна знайти на сторінці:
👉 API публічних реєстрів

Цей посібник стосується API для «Судового та економічного монітора», який ми надаємо в рамках продукту:
👉 API «Судового та економічного монітора» (MSIG API)

Нижче ми описали, як за допомогою API можна завантажити зміст оголошень та записів у KRS, опублікованих у MSIG для вказаного суб’єкта на підставі його номера KRS.

Крок 1: Отримати ключ авторизації в API

Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉 API «Судовий та господарський монітор» (MSIG API)

Крок 2: Викличте кінцеву точку Get Records

Дані, доступні в «Судовому та економічному моніторі», ми надаємо в MGBI API у вигляді набору даних з ідентифікатором pl-msig-record.

API надає для цієї моделі кінцеву точку Get Records, яка повертає записи, що містять текст поточного та повного витягу з КРС для суб’єктів, які відповідають вказаним критеріям.
👉 Документація кінцевої точки Get Records для моделі pl-msig-record

Щоб завантажити перелік оголошень та записів у KRS щодо окремого суб’єкта господарювання, у кінцевій точці Get Records необхідно вказати його номер KRS.

Приклад виклику ендпойнту Get Records з номером KRS:

GET /v1/models/pl-msig-record/records?identifiers.pl_krs=[номер KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [ключ авторизації]

Крок 3: З відповіді випишіть перелік оголошень та записів у КРС

При правильному виклику кінцевої точки Get Records у відповідь повертається список записів, що відповідають заданим критеріям.

У наведеному вище прикладі кінцева точка повинна повернути список результатів, що містить один або кілька записів:

{
    "count": [liczba wyników],
    "pages": [liczba stron wyników],
    "results": [
        {
            "id": [identyfikator rekordu],
            "entities": [dane podmiotów, których dotyczy ogłoszenie],
            "msig": [parametry ogłoszenia w MSIG],
            "content": [treść ogłoszenia],
            "meta": [metadane rekordu]
        }
    ]
}

Кожен запис у списку містить набір даних щодо окремого оголошення або запису в КРС.

Інформація про номер MSIG, з якого походить оголошення, міститься у словнику msig.

Зміст словника msig для окремого оголошення:

{
    "chapter": [rozdział MSIG],
    "section": [sekcja MSIG],
    "subsection": [podsekcja MSIG],
    "page_number": [numer strony MSIG z ogłoszeniem],
    "position_number": [numer pozycji ogłoszenia],
    "signature": [sygnatura ogłoszenia],
    "year": [rok wydania MSIG],
    "yearly_number": [numer roczny MSIG],
    "sequential_number": [numer kolejny MSIG]
}

Зміст оголошення у форматі XML міститься у полях словника content.

Зміст розділу «Контент» для окремого оголошення:

{
    "header_xml": [nagłówek ogłoszenia],
    "body_xml": [treść ogłoszenia],
    "krs_entry_xml": [treść wpisu do KRS]
}

Дізнайтеся більше:
👉 Структура даних у моделі pl-msig-record
👉 Документація щодо кінцевих точок для моделі pl-msig-record