VPD Playground | eConnect

Der VPD Playground ist eine grafische Weboberfläche, mit der Sie GraphQL-Abfragen gegen den VPD-Service schreiben und ausführen können, ohne Code schreiben oder einen HTTP-Client starten zu müssen. Ideal, um das Schema zu erkunden, Abfragen zu testen und Ergebnisse schnell einzusehen.

Zugang zum Playground

Der Playground ist auf der VPD-Website verfügbar:

Umgebung

URL

Produktion

https://vpd.econnect.eu

Akzeptanz

https://accp-vpd.econnect.eu

Sie benötigen gültige OAuth2-Credentials, um den Playground zu verwenden. Melden Sie sich mit Ihren Client Credentials (Scope vpd) an, um eine Sitzung zu starten.

Was können Sie mit dem Playground tun?

Der Playground bietet einen Editor mit Syntax-Highlighting und Autocomplete für GraphQL. Sie tippen Ihre Abfrage im linken Panel und sehen das Ergebnis direkt im rechten Panel. Die wichtigsten Möglichkeiten:

Schema erkunden: Über den integrierten Dokumentations-Explorer sehen Sie alle verfügbaren Felder, Typen und Suchparameter
Abfragen schreiben und ausführen: Tippen Sie eine Abfrage, drücken Sie den Play-Button und sehen Sie das Ergebnis als JSON
Variablen verwenden: Definieren Sie Variablen im Variablen-Panel, um Abfragen wiederverwendbar zu machen
Ergebnisse inspizieren: Das JSON-Ergebnis ist direkt in der Oberfläche lesbar

Eine Abfrage ausführen

Öffnen Sie den Playground, authentifizieren Sie sich mit Ihren Credentials und führen Sie zum Beispiel diese Abfrage aus:

{
  parties(name: "eConnect", country: "NL", maxResults: 3) {
    legalName
    partyIds {
      type
      value
    }
    locations {
      city
    }
  }
}

Die Antwort erscheint direkt im rechten Panel. Sie sehen den juristischen Namen, die Identifier und den Standort der gefundenen Organisationen.

Schema-Dokumentation

Auf der rechten Seite des Playground finden Sie den Dokumentations-Explorer. Klicken Sie auf einen Typ oder ein Feld, um die verfügbaren Unterfelder zu sehen. Dies ist der schnellste Weg zu entdecken, welche Daten verfügbar sind, ohne die API-Dokumentation separat zu konsultieren.

Der Explorer zeigt das vollständige Party-Schema einschließlich Feldtypen, Beschreibungen und ob ein Feld optional ist. Verwenden Sie dies als Nachschlagewerk beim Erstellen Ihrer Abfragen.

Tipps

Testen Sie immer zuerst auf der Akzeptanzumgebung (accp-vpd.econnect.eu), bevor Sie Abfragen in der Produktion ausführen. Verwenden Sie den maxResults-Parameter, um die Anzahl der Ergebnisse während des Testens zu begrenzen. Und nutzen Sie die Autocomplete-Funktion im Editor: Sie spart Tipparbeit und verhindert Fehler bei Feldnamen.

Möchten Sie die VPD strukturell in Ihre Anwendung einbinden? Lesen Sie, wie Sie die VPD in Ihre Integration einbinden.

VPD Playground öffnen

Verwandt