Wie kann man über die API eine Liste der Konzessionen, Genehmigungen und Einträge im RDR für ein im KRS eingetragenes Unternehmen abrufen?

MGBI bietet eine umfassende API zum Abruf von Daten aus öffentlichen Registern und Verzeichnissen, darunter aus den Registern für regulierte Tätigkeiten (RDR).

Eine Liste der in diesem Dienst verfügbaren Datenquellen findest du auf der Seite:
👉Öffentliche Register API

Dieser Leitfaden bezieht sich aufdie API für die Register für regulierte Tätigkeiten (RDR) für Unternehmen, die im Landesgerichtsregister (KRS) eingetragen sind, und die wir im Rahmen des folgenden Produkts zur Verfügung stellen:
👉API für Register für regulierte Tätigkeiten (RDR-API)

Im Folgenden beschreiben wir, wie Sieüber die API die Inhalte von RDR-Einträgen für bestimmte Unternehmen anhand ihrer Registrierungsnummern (KRS, NIP oder REGON)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 für Register regulierter Tätigkeiten (RDR-API)

Schritt 2: Rufe den Endpunkt „Create Refresh“ auf

Die im RDR verfügbaren Daten stellen wir in der MGBI-API im Datenmodell mit der Kennung„pl-rdr-record“ bereit.

Dieses Modell wird auf Anfrage synchronisiert, was bedeutet, dass wir in unseren Beständen keine vollständige Kopie der im Quellregister verfügbaren Daten dafür haben.

Um aktuelle Daten zu dem angegebenen Unternehmen aus dem Modell abzurufen, musst du zunächst über den Endpunkt„Create Refresh“ einen Auftrag zum Abrufen dieser Daten aus dem RDR erstellen.
👉Dokumentation zum Endpunkt „Create Refresh“

Beispiel für den Aufruf des Endpunkts „Create Refresh“ mit einer KRS-Nummer:

POST /v1/refresh HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

{
    "query": {
        "model": "pl-rdr-record",
        "identifiers.pl_krs": "[numer KRS]"
    }
}

Bei korrekter Aufrufung des Endpunkts„Create Refresh“wird als Antwort ein Dictionary zurückgegeben, das im Feld„id“ die Auftrags-ID enthält.

Schritt 3: Rufe den Endpunkt „Get Refresh“ auf

Aufträge zum Abrufen von Daten aus dem Quellregister dauern in der Regel einige bis etwa zehn Sekunden ab dem Zeitpunkt ihrer Erstellung durch den Endpunkt„Create Refresh“.

Um den aktuellen Status des Auftrags zu überprüfen, rufe den Endpunkt„Get Refresh“auf und gib in der URL die im vorherigen Schritt erhaltene Auftrags-ID an.
👉Dokumentation zum Endpunkt „Get Refresh“

Beispiel für den Aufruf des Endpunkts „Get Refresh“ mit einer Auftrags-ID:

GET /v1/refresh/[Auftrags-ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]

Wenn das Feld „status“ im zurückgegebenen Dictionary den Wert„pending“ annimmt, wird der Auftrag noch ausgeführt, und der Endpunkt„Get Refresh“sollte in einigen Sekunden erneut aufgerufen werden.

Wenn das Statusfeld den Wert„success“ annimmt, bedeutet dies, dass der Auftrag ausgeführt wurde und die Daten zum angegebenen Schuldner bereits aus dem Quellregister abgerufen wurden.

Schritt 4: Rufe den Endpunkt „Get Records“ auf

Die API für das Modell„pl-rdr-record“stellt den Endpunkt„Get Records“ bereit, der Datensätze mit dem vollständigen Antworttext aus dem RDR-Register für die angegebene KRS-Nummer zurückgibt.
👉Dokumentation zum Endpunkt „Get Records“ für das Modell „pl-rdr-record“

Um die aus dem Quellregister abgerufenen Daten in einem zuvor erstellten Auftrag abzurufen, rufen Sie den Endpunkt„Get Records“ auf und übergeben Sie dabei die Auftrags-ID im Parameter„refresh_id“.

GET /v1/models/pl-rdr-record/records?refresh_id=[Auftrags-ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [Autorisierungsschlüssel]

Schritt 5: Entnehmen Sie der Antwort die Liste der Konzessionen, Genehmigungen und Einträge im RDR für das angegebene Unternehmen

Ein korrekter Aufruf des Endpunkts „Get Records“ gibt als Antwort eine Liste der Datensätze zurück, 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]",
            "content": "[treść odpowiedzi]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Alle im RDR für das angegebene Unternehmen verfügbaren Daten zu einzelnen Berechtigungen findest du in den Elementen der Liste ` content.raw_result.permissions`.

Beispiel für den Inhalt des Listenelements „content.raw_result.permissions“:

{
    "from": "[data początkowa okresu obowiązywania]",
    "to": "[data końcowa okresu obowiązywania]",
    "name": "[nazwa uprawnienia]",
    "description": "[opis uprawnienia]",
    "issueAuthorityName": "[nazwa organu wydającego]"
}

Weitere Informationen:
👉Datenstruktur im Modell „pl-rdr-record“
👉Dokumentation der Endpunkte für das Modell „pl-rdr-record“