Zum Hauptinhalt springen

Schnellstart · Ihre erste Anfrage in drei Schritten

Ziel: eine funktionierende HTTP-Anfrage von Grund auf bauen. Wenn Sie die Hauptlinie „Gruppe → Umgebung → Request“ verstanden haben, ist jedes andere Protokoll nur ein anderes Protokoll mit einer anderen Pre-URL.


Schritt 1: Gruppe anlegen, Umgebung binden​

In Quick Request ist die Umgebung an die Gruppe gebunden, und alle Requests der Gruppe teilen sie.

  1. Neue Gruppe anlegen (z. B. Meine erste Gruppe).
  2. Der Gruppe eine Umgebung binden. Gibt es noch keine, zuerst eine Umgebung anlegen (z. B. Lokal).

Warum die zusätzliche Ebene? Weil Sie beim Wechsel eines Moduls zwischen dev / staging / production nur die Umgebung bearbeiten wollen — nicht Dutzende Requests.


Schritt 2: Pre-URL in der Umgebung eintragen​

Eine Umgebung hält eine Basisadresse pro Protokoll. Für HTTP die Zeile http ausfüllen:

ProtokollzeileBeispiel-BasisadresseHinweis
HTTPhttp://127.0.0.1:18080Mit https:// TLS aktivieren
WebSocketws://127.0.0.1:18085Mit wss:// TLS aktivieren
gRPCgrpc://127.0.0.1:18089Mit grpcs:// TLS aktivieren
MQTTmqtt://127.0.0.1:18884Mit mqtts:// TLS aktivieren

⚠️ Die einfachste Falle: Zu welchem Protokoll eine Basisadresse gehört, entscheidet das Scheme am Anfang der URL — nicht die Zeile, in die Sie sie tippen. Eine WebSocket-Basisadresse muss als ws://… oder wss://… geschrieben werden; tippen Sie versehentlich https://…, wird sie als HTTP behandelt, die WebSocket-Anfrage findet keine Basisadresse und schlägt fehl. Halten Sie Protokollzeile und Scheme konsistent.

(Die Ports wie 18080 oben stammen vom Beispiel-Testserver; beim Testen eigener APIs durch Ihre echten Adressen ersetzen.)


Schritt 3: Request anlegen, nur das Pfadfragment eintragen, senden​

Request innerhalb der Gruppe anlegen:

  1. Protokoll: HTTP; Methode: GET.
  2. URL — nur das Pfadfragment eintragen: /echo (nicht den vollen Host — der Host kommt bereits aus der http-Pre-URL der Umgebung).
  3. Senden antippen.

Sie sehen, wie /echo genau das zurückgibt, was Sie gesendet haben. Über die Leitung ging tatsächlich http://127.0.0.1:18080/echo.


Es läuft — was kommt als Nächstes?​

  • Verstehen wollen, „warum nur /echo“ und „woher {{x}} kommt“ → Kernkonzepte
  • Anfragen vor dem Senden signieren / Antworten entschlüsseln → Skripte
  • Ein Rezept „Login für Token, automatisch für die ganze Gruppe anhängen“ kopieren → Rezepte
  • Protokoll wechseln (WS/TCP/UDP/gRPC/MQTT) → die passende Protokollseite (siehe Übersicht)