gRPC, WebSocket, SSE und GraphQL
Neben HTTP spricht RequestTailor gRPC, WebSocket, Server-Sent Events und GraphQL1. 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
GRPCundWSneben 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

- Die Methode wählst du aus der Liste der Dienste; daneben steht die Art (unär, Server-, Client- oder bidirektionales Streaming).
- Use template füllt die Nachricht mit einem JSON-Gerüst der Eingabenachricht, Reload lädt die Dienste neu.
- 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.protobufinopencollection.yml), - oder der Server-Reflection des Dienstes (
grpc.reflection.v1, ersatzweisev1alpha), wenn es keine Datei gibt.
- Einen neuen Request anlegen und als Methode
GRPCwählen; die Adresse des Dienstes in die URL schreiben, gern mit Variable. - Im Tab Messages die Methode aus der Liste wählen und Use template klicken.
- Die Felder im JSON ausfüllen. Metadaten wie ein Token kommen in den Tab Metadata, Anmeldung in Auth.
- 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

- Einen Request mit der Methode
WSanlegen und diews://- oderwss://-Adresse eintragen. - Im Tab Messages mit + Nachrichten anlegen, jeder einen Namen und das Format (Text oder Binär) geben. Sie werden mit dem Request gespeichert.
- Verbinden. Die gewählte Nachricht geht nach dem Öffnen hinaus; weitere schickt der Knopf Send „…“ rechts über dem Verlauf.
- 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
- Funktionen im Überblick Funktionen · Protokolle
- Doku Begleitdienst rt agent
- Doku Requests senden
- Doku Authentifizierung
- Belege CLAUDE.md1 · rt-cli/README.md2