Schnellstart (5 Minuten)

Ziel: Von einer frischen Installation aus zu einer authentifizierten Anfrage gelangen, deren URL und Token aus Variablen stammen. Rechnen Sie mit fünf Minuten.

1. Ein Projekt anlegen

Datei ▸ Neu (Ctrl+N), dann Datei ▸ Speichern unter (Ctrl+Shift+S), um ihm einen Namen zu geben, zum Beispiel demo.restorm.

Ein Projekt ist eine einfache Datei auf Ihrer Festplatte. Sie können sie schon jetzt in ein Git-Repository legen – genau dafür ist Restorm gemacht.

2. Einen Variablenordner anlegen

Rechtsklick im Seitenbaum ▸ Hinzufügen ▸ Variablenordner.

Ein Variablenordner (oder Umgebungsordner) ist der Container, der Ihre Umgebungen trägt – local, staging, production – und damit Ihre {{variables}}. Alle darin enthaltenen Anfragen erben die ausgewählte Umgebung.

Öffnen Sie ihn, legen Sie eine Umgebung local an und fügen Sie ihr eine Variable hinzu:

Schlüssel	Typ	Wert
`baseUrl`	Zeichenkette	`https://api.exemple.test`

Der Tab eines Variablenordners, auf seinem Unter-Tab Umgebungen: die ausgewählte Umgebung links und ihre Variable baseUrl rechts

3. Eine Anfrage erstellen und senden

Rechtsklick auf den Ordner ▸ Hinzufügen ▸ HTTP-Anfrage. Im sich öffnenden Tab:

lassen Sie die Methode auf GET;
geben Sie die URL {{baseUrl}}/health ein – der aufgelöste Wert wird unter dem Feld angezeigt, das ist Ihr Sicherheitsnetz;
klicken Sie auf Send.

Die Antwort öffnet sich darunter: Status, Zeit, Größe, Header und der Body, dargestellt in einem einklappbaren JSON-Viewer.

Eine HTTP-Anfrage, deren URL {{baseUrl}} verwendet, mit dem rechts geöffneten Antwortbereich – Status, Zeit, Größe und JSON-Body

4. Authentifizierung hinzufügen

Statt ein Token fest einzutragen, legen Sie eine Authentifizierungsanfrage an: Rechtsklick ▸ Hinzufügen ▸ Authentifizierungsanfrage. Konfigurieren Sie den Aufruf, der das Token beschafft (zum Beispiel ein POST /oauth/token), und deklarieren Sie anschließend in dessen Tab Konfiguration, was er liefert:

Erzeugter Header	Wert
`Authorization`	`{{token_type}} {{access_token}}`

Der Wert ist ein Ausdruck, der über dem Body der Antwort der Authentifizierungsanfrage ausgewertet wird. Tragen Sie dabei auch den Ablaufausdruck ein (zum Beispiel {{expires_in}}), damit Restorm das Token automatisch erneuert.

Kehren Sie zu Ihrer GET-Anfrage zurück und wählen Sie oben in der Leiste diese Authentifizierungsroute aus. Der Header wird ab sofort bei jedem Senden eingefügt, und ein 401 löst automatisch eine Erneuerung und einen neuen Versuch aus.

Details: Authentifizierung.

5. Weiterführend

Sie haben bereits eine Spezifikation oder eine Sammlung? Datei ▸ Importieren (Ctrl+I) baut den gesamten Baum wieder auf: siehe Import & Export.
Verketten Sie mehrere Aufrufe und prüfen Sie die Ergebnisse mit einem Szenario.
Lassen Sie dieses Szenario in Ihrer CI laufen: Headless-Ausführung.