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 →

Collections als Dateien

Der Ordner ist die Collection. Die App liest ihn und schreibt Änderungen zurück; eine eigene Kopie hat sie nicht. Jeder Request ist eine lesbare YAML-Datei im Format OpenCollection, sodass ein Diff in Git genau zeigt, was du geändert hast.

Format
OpenCollection 1.0 (YAML), wie Bruno es schreibt
Wurzel
opencollection.yml
Je Request
eine Datei
Speichern
byte-gleich für Unverändertes

Aufbau des Ordners

my-api/
  opencollection.yml    die Collection: Name, Standard-Header, Auth, Variablen
  users/
    folder.yml          optional: Ordnername, Reihenfolge, Standards für seine Requests
    get-user.yml        ein Request je Datei
    create-user.yml
  environments/
    Local.yml           eine Datei je Umgebung
    Staging.yml

Ein Ordner innerhalb der Collection, der eine eigene opencollection.yml hat, ist eine eigene Collection. Die App ist nur eine Sicht auf den Ordner: Was du in ihr änderst, landet als Dateiänderung im Ordner, und was du im Editor änderst, sieht die App beim nächsten Lesen.

Eine Request-Datei

info:
  name: Get user
  type: http
  seq: 1
http:
  method: GET
  url: "{{baseUrl}}/users/{{userId}}"
  headers:
    - name: Accept
      value: application/json
  auth: inherit

auth: inherit übernimmt die Authentifizierung des Ordners oder der Collection. Für den Query-String ist die URL die Wahrheit; Query-Parameter in einer params-Liste spiegeln sie nur. Variablen schreibst du als {{name}} – woher ihr Wert kommt, erklärt Umgebungen und Variablen.

Body-Dateien (Datei-Bodies, Multipart-Teile) liest RequestTailor relativ zur Wurzel der Collection. Absolute Pfade, .. und symbolische Links, die aus dem Ordner führen, werden abgelehnt.

OpenCollection und Bruno

Die Dateien folgen OpenCollection 1.0, dem YAML-Format, das Bruno schreibt. Bruno-Collections in diesem Format öffnest du unverändert mit Open folder. OpenCollection erlaubt keine unbekannten Felder; eigene Daten von RequestTailor – etwa die Regeln für KI-Agenten – stehen im Abschnitt extensions der opencollection.yml oder in Begleitdateien.

Speichern ohne Nebenwirkungen

Lesen und Schreiben ergibt byte-identische Dateien, Kommentare und Formatierung eingeschlossen. Änderst du einen Request, ändert sich nur dieser Teil dieser Datei – ein Diff zeigt, was du getan hast, und sonst nichts. Die Testsuite prüft das bei jedem Commit an 86 Bruno-Collections. Was ein Schreiber nicht exakt kann, verweigert die Rücklese-Prüfung, statt die Datei still zu verändern.

Neue Collection und neue Requests

  1. Die Collection mit Open folder öffnen.
  2. New request wählen (Mod+N, oder + neben REQUESTS in der Seitenleiste).
  3. Methode, URL, Header und Body eintragen.
  4. Mit Mod+S speichern. Die App schreibt eine neue YAML-Datei in den Ordner.

Bestehende Sammlungen aus Postman, Insomnia, OpenAPI, cURL, HAR oder .http holst du mit Import.

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

    Requests als OpenCollection-YAML, eine Datei je Request ↑Produkt · Repo des Kerns von RequestTailor, CLAUDE.md (Produktprinzip „Dateien sind die Wahrheit“), crates/rt-format, website/docs/collections · geprüft am 22.11.2026

  2. 2

    Byte-gleicher Round-Trip, 86 Bruno-Collections ↑Produkt · Repo des Kerns von RequestTailor, testdata/collections/bruno, crates/rt-format (Round-Trip-Tests) · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Kann ich die Dateien auch mit einem Texteditor ändern?
Ja. Die Dateien sind lesbares YAML; die App liest den Ordner beim nächsten Öffnen oder Neuladen neu. Sie hält keine eigene Kopie.
Was passiert mit Kommentaren in meinen YAML-Dateien?
Sie bleiben erhalten. Lesen und Schreiben ist byte-gleich; beim Speichern ändert sich nur der Teil, den du geändert hast.
Muss ich die Collection in Git haben?
Nein. Eine Collection ist ein Ordner; Git ist optional. Mit Git bekommst du Diffs, Branches und Reviews ohne Spezialwerkzeug.

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.