RequestTailor Vorschau (22.11.2026): Requests als Dateien in Git, ohne Konto, offline – auf dem Mac, im Browser und in der Pipeline. Was drin ist → +43 664 1964199Kontakt →

gRPC, WebSocket, SSE und GraphQL

Neben HTTP spricht RequestTailor gRPC, WebSocket, Server-Sent Events und GraphQL. Jeder dieser Requests ist eine Datei in der Collection wie jeder andere, nutzt dieselben Variablen, Auth und Plugins und läuft auf dem Mac, in der Web-App und mit rt send. Secret-Werte sind im Nachrichtenverlauf maskiert, auch in empfangenen Nachrichten.

Edition
Free
Methode
GRPC und WS neben den HTTP-Methoden
gRPC
unär und streamend, .proto oder Server-Reflection
Im Browser
Sitzungen über den Begleitdienst rt agent
Kommandozeile
rt send, für SSE mit --sse

Sitzungen statt einzelner Antworten

gRPC, WebSocket und SSE sind Sitzungen: Statt Send zeigt der Request einen Knopf zum Verbinden, danach Disconnect. Vorbereitet wird wie beim Senden – Variablen, Auth einschließlich OAuth 2.0, Plugins, Cookies und Pre-request-Skripte –, dann öffnet sich die Verbindung. Unten erscheint der Nachrichtenverlauf:

  • eine Zeile je Ereignis mit Zeit seit dem Verbinden: verbunden (mit Handshake oder Antwortkopf), gesendet (↑), empfangen (↓), geschlossen oder Fehler;
  • Filter messages durchsucht den Verlauf; ein Klick auf eine Zeile zeigt die Nachricht formatiert und zum Kopieren;
  • die Liste ist virtuell: Auch lange Verläufe bleiben flüssig, und solange du am Ende stehst, rollt sie mit.

Header des Requests sind bei WebSocket die Header des Handshakes, bei gRPC die Metadaten (Tab Metadata).

gRPC

gRPC-Request Countdown mit Methode GRPC, Tab Messages, gewählter Methode Countdown · Server streaming, Pfad /rt.echo.v1.EchoService/Countdown, JSON-Nachricht und darunter Verlauf mit Connected: 200, einer gesendeten und einer empfangenen Nachricht
Ein Server-Streaming-Aufruf: Methode wählen, Nachricht als JSON, Verlauf darunter.
  1. Die Methode wählst du aus der Liste der Dienste; daneben steht die Art (unär, Server-, Client- oder bidirektionales Streaming).
  2. Use template füllt die Nachricht mit einem JSON-Gerüst der Eingabenachricht, Reload lädt die Dienste neu.
  3. Nachrichten schreibst du als JSON. RequestTailor kodiert sie in Protobuf und zeigt empfangene Nachrichten wieder als JSON.

Die Dienste kommen aus einer von drei Quellen:

  • der .proto-Datei des Requests,
  • den .proto-Dateien und Importpfaden der Collection (config.protobuf in opencollection.yml),
  • oder der Server-Reflection des Dienstes (grpc.reflection.v1, ersatzweise v1alpha), wenn es keine Datei gibt.
  1. Einen neuen Request anlegen und als Methode GRPC wählen; die Adresse des Dienstes in die URL schreiben, gern mit Variable.
  2. Im Tab Messages die Methode aus der Liste wählen und Use template klicken.
  3. Die Felder im JSON ausfüllen. Metadaten wie ein Token kommen in den Tab Metadata, Anmeldung in Auth.
  4. Verbinden. Bei unären Aufrufen und Server-Streaming wird die Nachricht gesendet, sobald die Verbindung steht; bei Client- und bidirektionalem Streaming schickst du weitere Nachrichten mit Send message und beendest den Strom mit End stream.

Request-Dateien bleiben OpenCollection-Einträge vom Typ grpc, wie Bruno sie schreibt.

WebSocket

WebSocket-Request Echo socket mit Methode WS und URL ws://127.0.0.1:47811/ws/echo, Tab Messages mit Message 1 und Message 2 im Format Text, darunter Verlauf mit Connected: 101 und je zwei gesendeten und empfangenen Nachrichten
Gespeicherte Nachrichten als Reiter; der Knopf rechts sendet die gewählte.
  1. Einen Request mit der Methode WS anlegen und die ws://- oder wss://-Adresse eintragen.
  2. Im Tab Messages mit + Nachrichten anlegen, jeder einen Namen und das Format (Text oder Binär) geben. Sie werden mit dem Request gespeichert.
  3. Verbinden. Die gewählte Nachricht geht nach dem Öffnen hinaus; weitere schickt der Knopf Send „…“ rechts über dem Verlauf.
  4. Disconnect schließt die Verbindung; der Verlauf zeigt Code und Grund.

Server-Sent Events

SSE ist ein gewöhnlicher HTTP-Request. Sobald er einen aktivierten Header Accept: text/event-stream hat, öffnet RequestTailor ihn als Sitzung und zeigt jedes Ereignis als eigene Zeile, mit Name und ID des Ereignisses. Ohne den Header bleibt es ein normaler Request mit einer Antwort.

GraphQL

GraphQL ist HTTP mit einem eigenen Body-Typ: Query und Variables (JSON), gesendet als JSON. Der Editor holt das Schema per Introspection – gesendet wie der Request selbst, mit dessen Auth – und merkt es sich je URL und Umgebung, bis du es neu lädst. Damit gibt es Vervollständigung und Prüfung der Abfrage gegen das Schema und einen Schema-Browser mit Typen, Feldern, Argumenten, Beschreibungen und veralteten Feldern, durchsuchbar. Ohne Schema funktioniert der Editor trotzdem, nur ungeprüft.

Für KI-Agenten gilt eine GraphQL-Abfrage als lesend, solange sie keine mutation enthält (siehe Lesen oder schreiben).

In der Web-App: über den Begleitdienst

Ein Browser kann weder gRPC über HTTP/2 noch beliebige WebSocket-Header selbst senden. In der Web-App laufen deshalb alle Sitzungen über den Begleitdienst rt agent auf deinem Rechner, der sie mit demselben nativen Kern öffnet und die Ereignisse zurück in den Browser reicht. Wie du ihn startest und koppelst, steht in Begleitdienst rt agent.

Sitzungen mit rt send

rt send ws/echo.yml --env Local --message "Message 2" --duration 5
rt send grpc/countdown.yml --until-close
rt send events/stream.yml --sse --duration 30

rt send öffnet die Sitzung, sendet die gewählte Nachricht (oder die mit --message) und schließt standardmäßig nach der ersten empfangenen Nachricht oder nach 10 Sekunden. --duration SEKUNDEN hält sie so lange offen, --until-close bis der Server sie beendet. Ausgegeben wird der maskierte Verlauf als JSON. Exit-Code 0, wenn die Sitzung offen war, 1 bei einem Transportfehler, 2 wenn Request oder Nachricht fehlen, 3 wenn der Request nicht vorbereitet werden konnte.

Siehe auch

Fundstellen auf dieser Seite

Die hochgestellten Ziffern im Text verweisen hierher. Antippen zeigt die Fundstelle direkt an der Textstelle, alle Fundstellen der Website stehen gesammelt auf einer Seite.

  1. 1

    gRPC, WebSocket, SSE und GraphQL ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-core (stream), crates/rt-grpc, launch/wave8/RELEASE-NOTES.md · geprüft am 22.11.2026

  2. 2

    Begleitdienst rt agent für die Web-App ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-cli/src/agent, crates/rt-cli/README.md (Sicherheitsmodell) · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Brauche ich für gRPC eine .proto-Datei?
Nein. Bietet der Dienst Server-Reflection an, liest RequestTailor die Dienste daraus. Sonst nimmst du die .proto-Datei des Requests oder die .proto-Dateien und Importpfade der Collection.
Werden Secrets im Nachrichtenverlauf angezeigt?
Nein. Secret-Werte erscheinen im Verlauf als ***, auch wenn der Server sie in einer Nachricht zurückschickt – in der App, in der Web-App und in der Ausgabe von rt send.
Warum braucht die Web-App für WebSocket und gRPC den Begleitdienst?
Weil der Browser gRPC nicht selbst sprechen kann und beim WebSocket weder alle Header noch Client-Zertifikate erlaubt. Der Begleitdienst rt agent öffnet die Sitzung mit dem nativen Kern auf deinem Rechner und reicht nur die Ereignisse weiter.

Deine Frage ist nicht dabei? Sprich mich an: +43 664 1964199 office@clouddna.at Schreib mir

Kontakt

Requests im Repo statt im Konto? Sprich mit uns.

Free ist kostenlos und bleibt es. Für eine Vorabversion, für Enterprise, für das OData-Plugin an eurem SAP-System oder für einen Wunsch an Pro und Team: Schreib mir. Ich antworte innerhalb eines Werktags, persönlich.

Martin KochGeschäftsführer, CloudDNAIch lese jede Anfrage selbst und antworte persönlich.