Posting-Befehle

Umfassende Posting-TUI-HTTP-Client-Befehle und Workflows für API-Tests im Terminal.

Installation

Befehl	Beschreibung
uv tool install posting	Posting über uv installieren (empfohlen)
pipx install posting	Posting über pipx installieren
brew install posting	Posting über Homebrew installieren (macOS)
posting --version	Posting-Version anzeigen
posting	Posting TUI starten
posting --collection ./my-api	Mit spezifischem Collection-Verzeichnis starten
posting --env .env.dev	Mit Umgebungsdatei starten

Navigation

Tastaturkürzel	Beschreibung
Tab	Fokus zwischen Panels zyklisch wechseln
Shift + Tab	Fokus rückwärts zyklisch wechseln
Ctrl + J	Jump-Modus (zu beliebigem Panel nach Label springen)
Ctrl + P	Befehlspalette öffnen
Ctrl + Q	Posting beenden
j / k	In Listen herunter/hochfahren (Vim-Modus)
g / G	Zum Anfang/Ende der Liste springen
Escape	Dialog schließen oder Auswahl aufheben

Anfrage-Verwaltung

Tastaturkürzel	Beschreibung
Ctrl + N	Neue Anfrage erstellen
Ctrl + S	Aktuelle Anfrage speichern
Ctrl + Shift + S	Anfrage als neue Datei speichern
Ctrl + D	Aktuelle Anfrage duplizieren
Ctrl + Delete	Aktuelle Anfrage löschen
Ctrl + R	Aktuelle Anfrage umbenennen
Enter	Aktuelle Anfrage senden
Ctrl + L	URL-Leiste fokussieren

HTTP-Methoden

Methode	Beschreibung
GET	Ressource abrufen
POST	Ressource erstellen
PUT	Ressource aktualisieren/ersetzen
PATCH	Teilweise Ressource aktualisieren
DELETE	Ressource löschen
HEAD	Nur Header abrufen
OPTIONS	Unterstützte Methoden abrufen

Anfrage-Konfiguration

Tab	Beschreibung
Headers-Tab	Anfrage-Header hinzufügen/bearbeiten
Body-Tab	Anfrage-Body-Inhalt festlegen
Query-Tab	URL-Abfrageparameter hinzufügen
Auth-Tab	Authentifizierung konfigurieren
Options-Tab	Anfrage-spezifische Optionen festlegen
Scripts-Tab	Pre/Post-Anfrage-Python-Skripte

Umgebungsvariablen

Aktion	Beschreibung
$VARIABLE_NAME in URL	Umgebungsvariable referenzieren
${VARIABLE_NAME} im Body	Variable im Body interpolieren
posting --env .env.dev	Umgebungsdatei beim Start laden
.env Datei im Collection-Root	Automatisch geladene Umgebung
.env.local Override-Datei	Lokale Overrides (gitignored)

YAML-Anfrage-Dateien

Feld	Beschreibung
name: My Request	Anzeigename der Anfrage
method: POST	HTTP-Methode
url: https://api.example.com/users	Ziel-URL
headers:	Anfrage-Header Zuordnung
body:	Anfrage-Body-Inhalt
params:	Abfrageparameter
auth:	Authentifizierungskonfiguration
scripts:	Pre/Post-Anfrage-Skripte

Beispiel-Anfrage-Datei

name: Create User
description: Create a new user account
method: POST
url: https://api.example.com/users
headers:
  Content-Type: application/json
  Authorization: Bearer ${API_TOKEN}
body:
  content: |
    {
      "name": "John Doe",
      "email": "john@example.com"
    }

Authentifizierungstypen

Typ	Beschreibung
Bearer Token	Authorization: Bearer <token>
Basic Auth	Base64-kodierter Benutzername:Passwort
API Key	Benutzerdefinierter Header mit API-Schlüssel
Keine Authentifizierung	Keine Authentifizierung

Pre/Post-Anfrage-Skripte

Hook	Beschreibung
pre_request.py	Python-Skript vor Anfrage ausgeführt
post_request.py	Python-Skript nach Antwort ausgeführt
Access request object	Anfrage im Pre-Skript ändern
Access response object	Antwort im Post-Skript verarbeiten
Variablen setzen	Werte für nachfolgende Anfragen speichern

Response-Viewer

Feature	Beschreibung
Body-Tab	Antwort-Body mit Syntax-Hervorhebung anzeigen
Headers-Tab	Response-Header anzeigen
Status-Code-Anzeige	HTTP-Status-Code und Text
Response-Zeit	Anfrage-Dauer in Millisekunden
Response-Größe	Response-Body-Größe
Ctrl + F	Im Response-Body suchen

Collection-Verwaltung

Aktion	Beschreibung
Verzeichnisstruktur = Collection	Ordnerhierarchie organisiert Anfragen
Unterverzeichnis erstellen	Zugehörige Anfragen gruppieren
.yaml Dateien = Anfragen	Jede YAML-Datei ist eine Anfrage
posting --collection <dir>	Spezifische Collection öffnen
Versionskontrolle mit Git	YAML-Dateien sind Git-freundlich

Import/Export

Aktion	Beschreibung
curl-Befehl in URL-Leiste einfügen	Von curl importieren
Ctrl + E	Aktuelle Anfrage als curl exportieren
Aus Postman importieren	Postman-Collections importieren
Aus OpenAPI importieren	OpenAPI/Swagger-Spezifikationen importieren
YAML-Dateien sind portabel	Anfragen via Dateien teilen

Konfiguration

Einstellung	Beschreibung
~/.config/posting/config.yaml	Globale Konfigurationsdatei
theme: monokai	Farbschema festlegen
vim_mode: true	Vim-Tastenkombinationen aktivieren
editor: nvim	Externer Editor festlegen
pager: less	Externer Pager festlegen
timeout: 30	Standard-Anfrage-Timeout (Sekunden)

Themes

Befehl	Beschreibung
posting --theme monokai	Mit Monokai-Theme starten
posting --theme dracula	Mit Dracula-Theme starten
posting --theme solarized	Mit Solarized-Theme starten
Benutzerdefinierten Theme in Konfiguration	Eigenes Farbschema definieren
posting --list-themes	Verfügbare Themes anzeigen

Tipps und Best Practices

Tipp	Beschreibung
Jump-Modus verwenden (Ctrl+J)	Schneller navigieren als mit Tab
Anfragen in Git speichern	Versionskontrolle für API-Tests
Umgebungsdateien verwenden	Zwischen dev/staging/prod wechseln
Pre/Post-Skripte schreiben	Auth-Token-Aktualisierung automatisieren
Ctrl+P Befehlspalette verwenden	Funktionen schnell entdecken
In Ordnern organisieren	Zugehörige Endpoints gruppieren
Variablen in URLs verwenden	Anfragen DRY und flexibel halten
Im $EDITOR für komplexe Bodies öffnen	Große Payloads extern bearbeiten