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 Seite:
👉 Ö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 anhand der PESEL-Nummer einer bestimmten Person nach Unternehmen im KRS suchen können, die mit dieser Person in Verbindung stehen.
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 von im KRS eingetragenen Unternehmen abzurufen, die mit einer bestimmten Person in Verbindung stehen, muss im Parameter „identifiers.pl_pesel.full“ die PESEL-Nummer dieser Person angegeben werden.
Beispiel für den Aufruf des Endpunkts „Get Records“ mit einer PESEL-Nummer:
GET /v1/models/pl-krs-wp-record/records?identifiers.pl_pesel.full=[PESEL-Nummer] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]
Wenn Sie nur an Unternehmen interessiert sind, mit denen die angegebene Person derzeit geschäftliche Beziehungen unterhält, können Sie alternativ auch den Parameter ` identifiers.pl_pesel.current` verwenden.
Schritt 3: Entnehmen Sie den Antworten die Daten der Unternehmen
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 oder mehreren Datensätzen zurückgeben:
{
"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]
},
...
]
}
Jedes Element der Ergebnisliste enthält einen Datensatz mit den Daten eines einzelnen, im KRS registrierten Rechtsträgers, mit dem die Person mit der angegebenen PESEL-Nummer verbunden ist oder in der Vergangenheit verbunden war.
Dort kannst du alle Informationen einsehen, die im aktuellen oder vollständigen Auszug zu diesem Unternehmen verfügbar sind.
Weitere Informationen:
👉 Datenstruktur im Modell „pl-krs-wp-record“
👉 Dokumentation der Endpunkte für das Modell „pl-krs-wp-record“
