nobledunross / api-schnellstart

Ein sanfter Einstieg in die APIs

Postman Calls für die EUROPACE APIs

Probeaufrufe (Calls) der APIs sind sehr hilfreich, um schnell einzusteigen. Dafür empfehlen wir Postman, was auf Windows, Mac OS und Linux funktioniert.

Voraussetzung um diese Calls auszuführen:

1. Du benötigst eine API Zugriff. Das beinhaltet entweder:
   • OAuth Client Credentials. Wo diese herkommen ist hier beschrieben.
   • eine PartnerID und einen API Key (für eine "Legacy Autorisierung").
2. Du benötigst mindestens einen Vorgang oder einen Antrag, um die Daten auszulesen.

Schritte um Postman einzurichten

1. Postman runterladen und installieren. Es ist keine Anmeldung erforderlich.

2. Oben links auf Import Button klicken, dann auf Import from Link

3. Folgenden Link in die Textbox pasten: https://raw.githubusercontent.com/europace/api-sandbox/master/EUROPACE%20API%20Calls.postman_collection.json

4. Ein neue Umgebung (Environment) anlegen in dem mehrere notwendige Variablen eingetragen werden müssen. Dafür das Icon oben rechts klicken:

5. Gib deiner Environment einen Namen und lege darin die folgende Variablen an:

Variablen Name	Woher bekomme ich das?
API_KEY	Siehe oben unter "Voraussetzung"
PARTNER_ID	Siehe oben unter "Voraussetzung"
CLIENT_ID	Siehe oben unter "Voraussetzung"
CLIENT_SECRET	Siehe oben unter "Voraussetzung"
SCOPES	Optional. Siehe hier

5. Stelle nach dem Anlegen der Environment sicher, dass diese auch aktiv ist:

6. Den Aufruf in der neuen Collection in der Linken spalte (Get OAuth Access-Token) anklicken

7. Beim Klick auf send müsste jetzt ein access_token zurück kommen.