MGBI надає комплексний API для отримання даних із державних реєстрів та облікових баз, зокрема із Системи надання доступу до даних про державну допомогу (SUDOP). Перелік джерел даних, доступних у цій службі, можна знайти на сайті:
👉Державні реєстри API
Цей посібник стосується API для Системи обміну даними про державну допомогу (SUDOP), яку ми надаємо в рамках продукту:
👉API Системи обміну даними про державну допомогу (SUDOP API)
Нижче ми описали, як за допомогою API можна завантажити записи з інформацією про окремі випадки надання допомоги, отриманої бенефіціаром, на основі реєстраційних номерів та інших параметрів.
Крок 1: Отримати ключ авторизації в API
Щоб отримати ключ авторизації, необхідний для виклику кінцевих точок, доступних в MGBI API, зв’яжіться з нами за допомогою контактної форми на сторінці продукту:
👉Система надання даних про державну допомогу API (SUDOP API)
Крок 2: Викличте кінцеву точку Get Records
Дані, доступні в SUDOP, ми надаємо в MGBI API у вигляді моделі даних з ідентифікаторомpl-sudop-wpopb-record.
API надає для цієї моделі кінцеву точкуGet Records, яка повертає записи з інформацією про окремі випадки надання державної допомоги з бази SUDOP, що відповідають вказаним критеріям.
👉Документація кінцевої точки Get Records для моделі pl-sudop-wpopb-record
Для отримання записів зі списком випадків надання допомоги, яку отримав певний суб’єкт господарювання, у кінцевій точціGet Recordsнеобхідно вказати його реєстраційний номер: KRS, NIP або REGON.
Приклад виклику ендпойнту Get Records із номером NIP:
GET /v1/models/pl-sudop-wpopb-record/records?identifiers.pl_nip=[номер NIP] 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": "[informacja o pomocy udzielonej beneficjentowi]",
"meta": "[metadane rekordu]"
}
]
}Усі дані щодо окремого випадку державної допомоги, оприлюдненого в SUDOP для зазначеного суб’єкта, можна знайти у словникуcontent.raw_result.
Приклад вмісту словника content.raw_result:
{
"dni-udzielenia-pomocy": "[dni udzielenia pomocy]",
"forma-pomocy-kod": "[kod formy pomocy]",
"forma-pomocy-nazwa": "[nazwa formy pomocy]",
"gmina-siedziby-kod": "[kod siedziby gminy]",
"gmina-siedziby-nazwa": "[nazwa siedziby gminy]",
"nazwa-beneficjenta": "[nazwa beneficjenta pomocy]",
"nazwa-udzielajacego-pomocy": "[nazwa podmiotu udzielającego pomocy]",
"nip-beneficjenta": "[NIP beneficjenta pomocy]",
"nip-udzielajacego-pomocy": "[NIP podmiotu udzielającego pomocy]",
"podstawa-prawna-2a-kod": "[kod podstawy prawnej 2a]",
"podstawa-prawna-2a-nazwa": "[nazwa podstawy prawnej 2a]",
"podstawa-prawna-2b": "[podstawa prawna 2b]",
"podstawa-prawna-2c": "[podstawa prawna 2c]",
"podstawa-prawna-3a": "[podstawa prawna 3a]",
"podstawa-prawna-3b": "[podstawa prawna 3b]",
"przeznaczenie-pomocy-kod": "[kod przeznaczenia pomocy]",
"przeznaczenie-pomocy-nazwa": "[nazwa przeznaczenia pomocy]",
"sektor-dzialalnosci-kod": "[kod sektora działalności]",
"sektor-dzialalnosci-nazwa": "[nazwa sektora działalności]",
"sektor-dzialalnosci-wersja": "[wersja klasyfikacji sektora działalności]",
"srodek-pomocowy-nazwa": "[nazwa środka pomocowego]",
"symbol-aktu-ogolnego": "[symbol aktu ogólnego]",
"wartosc-brutto-eur": "[wartość brutto pomocy w EUR]",
"wartosc-brutto-pln": "[wartość brutto pomocy w PLN]",
"wartosc-nominalna-pln": "[wartość nominalna pomocy w PLN]",
"wielkosc-beneficjenta-kod": "[kod wielkości beneficjenta]",
"wielkosc-beneficjenta-nazwa": "[nazwa wielkości beneficjenta]"
}Дізнайтеся більше:
👉Структура даних у моделі pl-sudop-wpopb-record
👉Документація щодо кінцевих точок для моделі pl-sudop-wpopb-record
