Zum Inhalt springen

HTTP und REST

Der gebräuchlichste Anfragetyp: alles, was HTTP spricht, allen voran REST-APIs.

Rechtsklick im Baum ▸ Hinzufügen ▸ HTTP-Anfrage.

Ein HTTP-Anfrage-Tab mit der URL, den Abschnitten Header / Pfad-Parameter / Parameter / Body und dem Antwortbereich rechts

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS und QUERY.

Die URL akzeptiert {{variables}} überall — Schema, Host, Port, Pfad, Query-String. Der aufgelöste Wert wird unter dem Feld angezeigt.

Drei Listen ergänzen die URL:

  • die Query-Parameter (?key=value);
  • die Pfad-Parameter, die benannte Pfadsegmente ersetzen;
  • die Header.

Jede Zeile hat ein Aktivierungsfeld, einen Werttyp und eine Beschreibung.

Vier Kategorien:

TypVerwendung
TextJSON, XML, Klartext — mit Syntaxhervorhebung und Neuformatierung
DateiSendet den Inhalt einer Datei von der Festplatte
Formular (multipart/form-data)Benannte Felder, inklusive Dateien
x-www-form-urlencodedBenannte, im Body kodierte Felder
  • Zeitlimit: in Millisekunden, spezifisch für diese Anfrage; sonst gilt der globale Wert.
  • Weiterleitungen folgen: standardmäßig aktiviert. Deaktivieren Sie es, um den 3xx-Status selbst und seinen Location-Header zu beobachten.

Status, Zeit, Größe, Header, und der Body dargestellt nach seinem Content-Type: einklappbarer JSON-Viewer, eingerücktes XML, Bildvorschau, Klartext. Der Verlauf-Tab bietet Zugriff auf frühere Ausführungen.

Verknüpfen Sie eine Authentifizierungsroute mit der Anfrage, damit Header eingefügt und das Token automatisch erneuert werden. Siehe Authentifizierung.

Restorm kann auch einen HTTP-Server hosten, um zu testen, wie ein Client ihn konsumiert — typischerweise der Code Ihrer Anwendung, den Sie für einen Testlauf auf localhost zeigen lassen.

Fügen Sie einen über Hinzufügen ▸ HTTP-Server hinzu: Er lauscht auf localhost:<port><path> für ein Paar aus Methode und Pfad und antwortet mit dem Status, den Headern und dem Body, die Sie dort konfigurieren. Weitere Protokolle werden auf dieselbe Weise gehostet — siehe Servermodus und Eine HTTP-API simulieren.

Im Tab Code Snippets stehen vierundzwanzig Sprachen und Bibliotheken zur Verfügung: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), natives Node.js, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Sie haben eine OpenAPI-Spezifikation, eine Postman-Collection, eine HAR-Datei oder einen einfachen curl-Befehl? Datei ▸ Importieren baut den Baum für Sie auf. Siehe Import & Export.