MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Krajowego Rejestru Sądowego (KRS). Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API
Ten poradnik dotyczy API dla wyszukiwarki podmiotów KRS, który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Sądowy API (KRS API) - Wyszukiwarka Podmiotów
Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API odpis aktualny z KRS w formacie PDF dla wskazanego podmiotu na podstawie jego numeru KRS.
Krok 1: Uzyskaj klucz autoryzacji w API
Aby zdobyć klucz autoryzacji wymagany przy wywoływaniu endpointów dostępnych w MGBI API, skontaktuj się z nami przy użyciu formularza kontaktowego na stronie produktu:
👉 Krajowy Rejestr Sądowy API (KRS API) - Wyszukiwarka Podmiotów
Krok 2: Wywołaj endpoint Get Records
Dane dostępne w wyszukiwarce podmiotów KRS udostępniamy w MGBI API w modelu danych o identyfikatorze pl-krs-wp-record.
API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy zawierające treść odpisu aktualnego oraz pełnego z KRS dla podmiotów spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-krs-wp-record
Pobranie danych pojedynczego podmiotu z KRS wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON. Przykład wywołania endpointu Get Records z numerem KRS:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_krs=[numer KRS] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Krok 3: Odczytaj z odpowiedzi adres do pobrania pliku
Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi listę rekordów spełniających podane kryteria.
W powyższym przykładzie endpoint powinien zwrócić listę wyników zawierającą jeden rekord:
{
"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]
}
]
}
Adres pliku PDF z treścią odpisu aktualnego z KRS dla wyszukanego podmiotu znajdziesz w polu files.current_excerpt_pdf_file.url.
Krok 4: Pobierz treść pliku i zapisz lub wyślij do przeglądarki
Aby pobrać treść pliku z odpisem aktualnym, wywołaj żądanie HTTP GET z adresem odczytanym z pola files.current_excerpt_pdf_file.url i kluczem autoryzacji w API:
GET [adres pliku] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Możesz też od razu wysłać treść pliku do przeglądarki internetowej użytkownika Twojej aplikacji. W tym przypadku ustaw wartość nagłówka HTTP Content-Type informującego przeglądarkę o formacie przesyłanego pliku na podstawie zawartości pola files.current_excerpt_pdf_file.content_type.
Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-krs-wp-record
👉 Dokumentacja endpointów dla modelu pl-krs-wp-record
