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 Ordner1: 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 Dateien2, 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
- Die Collection mit Open folder öffnen.
- New request wählen (Mod+N, oder + neben REQUESTS in der Seitenleiste).
- Methode, URL, Header und Body eintragen.
- 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
- Funktionen im Überblick Funktionen · dateien
- Doku Git
- Doku Import
- Doku Umgebungen und Variablen
- Belege Format1 · Round-Trip2