MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus dem Nationalen Gerichtsregister (KRS). Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Website:
👉 Öffentliche Register API
Dieser Leitfaden bezieht sich auf die API für die Suchmaschine für Unternehmen im KRS, die wir im Rahmen des Produkts
zur Verfügung stellen 👉 API des Nationalen Gerichtsregisters (KRS API) – Suchmaschine für Unternehmen
Im Folgenden beschreiben wir, wie Sie über die API einen aktuellen Auszug aus dem KRS im PDF-Format für ein bestimmtes Unternehmen anhand dessen KRS-Nummer abrufen können.
Schritt 1: Beziehen Sie einen Autorisierungsschlüssel über die API
Um den Autorisierungsschlüssel zu erhalten, der für den Aufruf der in der MGBI-API verfügbaren Endpunkte erforderlich ist, kontaktieren Sie uns bitte über das Kontaktformular auf der Produktseite:
👉 API des Nationalen Gerichtsregisters (KRS-API) – Suchmaschine für Rechtsträger
Schritt 2: Rufe den Endpunkt „Get Records“ auf
Die in der KRS-Unternehmenssuche verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung „pl-krs-wp-record“ bereit.
Die API stellt für dieses Modell den Endpunkt „Get Records“ zur Verfügung, der Datensätze mit dem Inhalt des aktuellen und vollständigen Auszugs aus dem KRS für Unternehmen zurückgibt, die die angegebenen Kriterien erfüllen.
👉 Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-krs-wp-record“
Um Daten zu einem einzelnen Unternehmen aus dem KRS abzurufen, muss am Endpunkt „Get Records“ dessen Registrierungsnummer angegeben werden: KRS, NIP oder REGON. Beispiel für den Aufruf des Endpunkts „Get Records“ mit einer KRS-Nummer:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_krs=[KRS-Nummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Schritt 3: Entnehmen Sie der Antwort die Adresse, unter der Sie die Datei herunterladen können
Bei korrekter Aufrufung des Endpunkts „Get Records“ wird als Antwort eine Liste der Datensätze zurückgegeben, die den angegebenen Kriterien entsprechen.
Im obigen Beispiel sollte der Endpunkt eine Ergebnisliste mit einem Datensatz zurückgeben:
{
"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]
}
]
}
Die URL der PDF-Datei mit dem aktuellen Auszug aus dem KRS für das gesuchte Unternehmen findest du im Feld ` files.current_excerpt_pdf_file.url`.
Schritt 4: Lade den Inhalt der Datei herunter und speichere ihn oder sende ihn an den Browser
Um den Inhalt der Datei mit dem aktuellen Auszug abzurufen, sende eine HTTP-GET-Anfrage mit der Adresse, die du aus dem Feld ` files.current_excerpt_pdf_file.url ` gelesen hast, und dem Autorisierungsschlüssel der API:
GET [Dateipfad] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Du kannst den Inhalt der Datei auch direkt an den Webbrowser des Nutzers deiner App senden. In diesem Fall musst du den Wert des HTTP-Headers „Content-Type“ festlegen, der den Browser über das Format der übertragenen Datei informiert, und zwar auf der Grundlage des Inhalts des Feldes `files.current_excerpt_pdf_file.content_type`.
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-wp-record“
