====== Postman ======

[[https://www.postman.com/|Postman]] ist ein mächtiges kostenloses Tool, um API's zu testen.

----

==== Die Postman Console ====

Mit der Tastenkombination [strg] + [alt] + [c] wird in einem separatem Fenster die Postman Console geöffnet. In diesem unverzichtbarem Werkzeug werden alle Requests und Response mit allen übertragenden Daten in Echtzeit angezeigt.

----

==== Debug mit XDEBUG (z. B. in PHPStorm) ====

Damit PHPStorm an den Breakpoints anhält muss der Request um ein entsprechendes Cookie erweitert werden:

  - Dialog "Cookies" aufrufen
  - Domain (z. B. http://localhost) hinzufügen
  - Für die Domain folgenden Cookie hinzufügen: "XDEBUG_SESSION=PHPSTORM;"

----

==== Verwendung von Variablen (Environments) ====
Unter dem Menüpunkt "Environments" können für unterschiedliche Umgebungen (meist Test- und Liveumgebung) angelegt werden. Diese können dann wie folgt in der URL oder als Parameter verwendet werden:

<code>{{URL}}/api.php/session</code>

Im Workspace kann dann rechts oben das entsprechende Environment geladen werden, damit die entsprechenden Variablen eingesetzt werden.

----

==== Verwendung einer dynamischer Session-ID ====

  - Environment-Variable anlegen (z. B. mit dem Namen "session")
  - Request, der die Session ausliest, um einen Test erweitern (siehe unten)
  - Die "Headers" im anderen Request um den Key (z. B. X-SESSION" mit dem Wert der Variable "session" ergänzen.

**Test-Script**
<code javascript>
pm.test("get Session ID", function() {
        var jsonData = pm.response.json();
        var sessId = jsonData["response"];
        postman.setEnvironmentVariable("session", sessId );
        console.log( "neue Session-ID wurde gespeichert: " + sessId );
    }
);
</code>

Alternativ kann auch postman.setGlobalVariable("session", sessId ); verwendet werden, um die Session als Globale Variable zu verwenden.