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 →

Kommandozeile rt

rt läuft mit demselben Kern wie die Apps: Was in der App grün ist, ist in der Pipeline grün. Die Ausgabe ist für Programme gemacht – JSON auf stdout, Exit-Codes, die eine Pipeline versteht – und Secrets gibst du als Variablen der Pipeline mit, nie in den Dateien.

Edition
Free
Systeme
macOS, Linux x86_64 und aarch64
Dazu
Docker-Image, GitHub Action
Ausgabe
JSON-Bericht, JUnit, Text
Exit-Codes
0 bis 4

Die Befehle

BefehlWofür
rt sendEinen Request senden; JSON-Bericht auf stdout
rt runEine Collection oder einen Ordner der Reihe nach senden, mit Tests und Assertions
rt importExporte anderer Werkzeuge in einen Collection-Ordner umwandeln
rt scanCollection-Dateien auf Zugangsdaten prüfen
rt mockMit den gespeicherten Beispielen antworten, als Mock-Server
rt docsEine statische HTML-Seite aus der Collection schreiben
rt mcp, rt approvals, rt approve, rt denyMCP-Server für KI-Agenten und seine Freigaben (KI-Agenten und MCP-Server)
rt mcp-testGespeicherte MCP-Tests ausführen (MCP-Client)
rt agentBegleitdienst für die Web-App (Begleitdienst rt agent)

rt --help und rt <befehl> --help zeigen alle Optionen. Die Downloads für macOS und Linux stehen auf der Download-Seite.

rt send

rt send <request-datei> [--env NAME] [--var NAME=WERT]... [--pretty]

Die Collection ist der nächste Ordner oberhalb der Request-Datei, der eine opencollection.yml enthält.

OptionBedeutung
-e, --env NAMEDie Umgebung NAME verwenden
--var NAME=WERTLaufzeit-Variable mit dem höchsten Rang, wiederholbar – für Secrets aus der Pipeline oder einen anderen Host
--body-limit BYTESHöchstens so viele Bytes des Bodys in den Bericht (Standard 10 MiB)
--plugin DATEI.wasm, --no-pluginsEin Plugin zusätzlich ausführen bzw. die installierten nicht
--cookie-jar DATEICookies aus der Datei senden und neue darin speichern
--no-promptScheitern statt auf eine OAuth-Anmeldung zu warten (Pipelines)
--no-scriptsSkripte der Collection nicht ausführen; Assertions laufen trotzdem
--prettyJSON einrücken

Die Ausgabe ist ein JSON-Objekt, der Bericht über den Versand: was auf die Leitung ging (Secrets als ***), die Antwort mit Status, Headern, Body und Zeiten, die verwendeten Variablen mit Herkunft, Platzhalter ohne Wert, Ergebnisse von Tests und Assertions und ein etwaiger Fehler. Die Web-App liefert denselben Bericht. WebSocket, gRPC und SSE (--sse) öffnen Sitzungen; dazu gRPC, WebSocket, SSE und GraphQL.

rt send health/status.yml --env CI --var token="$API_TOKEN" \
  | jq -e '.response.status == 200'

rt run

rt run sendet alle Requests einer Collection oder eines Ordners der Reihe nach und meldet Tests und Assertions – der Befehl für Pipelines. Variablen, die Skripte setzen, gelten für die folgenden Requests des Laufs, nie in den Dateien.

rt run                                     # die Collection (oder der Ordner), in der du bist
rt run api/users -e Staging --var token=$API_TOKEN
rt run . --data users.csv --reporter junit=reports/junit.xml --reporter json=reports/run.json
OptionBedeutung
--data DATEICSV oder JSON; jede Zeile ist eine Iteration mit eigenen Variablen
--iterations NDie Requests N-mal senden
--delay MSZwischen den Requests warten
--bailBeim ersten Fehlschlag aufhören
--reporter NAME[=DATEI]text, json oder junit, wiederholbar

junit schreibt JUnit-XML, wie GitHub, GitLab und Jenkins es lesen: eine Testsuite je Request, ein Testfall je Test und Assertion. json enthält je Schritt den vollständigen, maskierten Bericht von rt send. text läuft immer mit, eine Zeile je Request auf stderr.

Exit-Codes

Codert sendrt run
0Eine Antwort kam, egal mit welchem HTTP-StatusAlle Requests beantwortet, alle Tests und Assertions bestanden
1Keine Antwort: Verbindung, DNS, TLS, Zeitlimit, zu viele WeiterleitungenKein Netz-Stack
2Aufruffehler, keine Collection, ungültige Dateien, Request nicht in der CollectionAufruffehler, unbekannte Umgebung, unlesbare Datendatei
3Request nicht vorbereitbar: unbekannte Umgebung, ungültige URL, Auth gescheitert, Plugin oder Skript hat abgebrochenExterne Secrets oder Plugins nicht einrichtbar
4Antwort kam, aber ein Test oder eine Assertion scheiterteEin Request, Test oder eine Assertion scheiterte

In der Pipeline

Secrets gibst du als Variablen des Jobs an --var; in die Collection schreibst du sie nie. Mit --no-prompt scheitert ein OAuth-Flow, der eine Person braucht, statt zu warten.

GitHub Actions, mit der Action aus dem Repo des Kerns:

- uses: clouddnagmbh/requesttailor/github-action@v1
  with:
    collection: api
    environment: Staging
    junit: reports/junit.xml
  env:
    RT_VAR_token: ${{ secrets.API_TOKEN }}

GitLab CI oder jede andere Umgebung mit Docker, mit dem Image ghcr.io/clouddnagmbh/rt (minimal, ohne Shell, als Nutzer ohne Root-Rechte):

docker run --rm -v "$PWD:/work" ghcr.io/clouddnagmbh/rt run . --reporter junit=junit.xml

rt import

rt import shop.postman_collection.json prod.postman_environment.json --out ./shop
rt import api.yaml --format openapi --out ./api --json

Druckt den Verlustbericht. Exit-Code 0, sobald die Collection geschrieben ist, 2, wenn die Eingabe nicht lesbar oder --out nicht leer ist. Details in Import auf der Kommandozeile.

rt scan

Findet Zugangsdaten in Collection-Dateien, bevor sie in Git landen – derselbe Scanner, den die App vor jedem Commit laufen lässt. Exit-Code 0 ohne Funde, 1 mit Funden, 2, wenn ein Pfad nicht lesbar ist. Der Wert eines Fundes wird nie ausgegeben. Als Git-Hook vor dem Commit (.git/hooks/pre-commit, ausführbar):

#!/bin/sh
files=$(git diff --cached --name-only --diff-filter=ACMR -- '*.yml' '*.yaml' '*.json')
[ -z "$files" ] && exit 0
exec rt scan $files

rt mock und rt docs

Requests können Beispiele speichern: einen Request und die Antwort darauf (auch aus dem Postman-Import). rt mock antwortet damit, sodass App, Frontend oder Tests arbeiten können, bevor der echte Dienst existiert:

rt mock . --env Local --port 4010

Ein eingehender Request passt zu einem Beispiel über Methode und Pfad; passen mehrere, gewinnt das, dessen gespeicherter Request am besten passt. Ohne Treffer gibt es 404 mit einer Liste aller Routen. Der Mock hört auf 127.0.0.1, wenn du nicht --host angibst.

rt docs . --out site schreibt eine statische HTML-Seite mit Stylesheet: Ordner, Requests mit Methode, URL, Beschreibung, Parametern, Headern, Body, Auth-Art und Beispielen. Secret-Werte erscheinen nie; was nach Zugangsdaten aussieht, steht als *** da.

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

    Runner, rt run, JUnit und JSON, Exit-Code 4 ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-core (runner, assert), crates/rt-cli/README.md (Exit codes) · geprüft am 22.11.2026

  2. 2

    rt mock und rt docs ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-cli/src/mock.rs und docs.rs, launch/wave8/RELEASE-NOTES.md · geprüft am 22.11.2026

  3. 3

    macOS-App, Web-App, rt für macOS und Linux ↑Produkt · Repo des Kerns von RequestTailor, launch/RELEASE-NOTES.md (Entwurf für das erste Release), crates/rt-cli/README.md · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Wie lasse ich RequestTailor-Collections in der CI laufen?
Mit rt run, etwa rt run api -e Staging --var token=$API_TOKEN --reporter junit=junit.xml. Dafür gibt es eine GitHub Action und ein Docker-Image; Exit-Code 4 bricht den Build bei gescheiterten Tests.
Was bedeutet Exit-Code 0 bei einem HTTP-Fehler?
rt send meldet mit 0, dass eine Antwort kam – auch eine 404 oder 500. Prüfe den Status mit einer Assertion (dann Exit-Code 4) oder mit jq auf dem JSON-Bericht.
Wie kommen Secrets in die Pipeline?
Als Variablen des Jobs, die du mit --var übergibst; in der GitHub Action als RT_VAR_ mit dem Namen der Variable, etwa RT_VAR_token. In die Collection-Dateien schreibst du sie nie.

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.