Httpie: Was ist das, ein HTTP-Client für die Kommandozeile

Was ist Httpie und wie unterscheidet es sich von cURL

Httpie (oder HTTPie) ist ein in Python geschriebenes Kommandozeilen-Dienstprogramm, das das Senden von HTTP-Anfragen im Vergleich zu cURL vereinfacht. Der Hauptunterschied ist eine Syntax, die der natürlichen Sprache nahekommt: Argumente werden durch Leerzeichen getrennt, Header werden mit einem Doppelpunkt angegeben und JSON-Daten mit einem Gleichheitszeichen ohne Maskierung von Anführungszeichen.

Vergleich von cURL und Httpie

Dieselbe POST-Anfrage in cURL erfordert mindestens drei Flags (-X, -H, -d) und manuelles Maskieren von JSON. Httpie macht dasselbe mit drei Wörtern ohne Flags, setzt automatisch Content-Type: application/json und hebt die Ausgabe hervor. Die Antwort wird standardmäßig mit Einrückungen und Syntaxhervorhebung formatiert.

Anfragesyntax in Httpie

Httpie verwendet ein einheitliches Kommandozeilenformat ohne Flags für die wichtigsten Parameter. Die HTTP-Methode wird als erstes Argument angegeben (GET, POST, PUT, DELETE, PATCH), die URL als zweites. Wird die Methode weggelassen, wählt Httpie automatisch GET (für Anfragen ohne Text) oder POST (mit Text).

Arten von Argumenten

• Header:Value — Anforderungs-Header mit Doppelpunkt, ohne Leerzeichen nach dem Doppelpunkt: Authorization:"Bearer token".
• key=value — JSON-Objektfelder im Anforderungstext: name=John age=30.
• key:=value — Nicht-String-JSON-Werte (Zahlen, boolesche Werte, Arrays): active:=true tags:=["dev","test"].
• key@file — Laden eines Werts aus einer Datei: avatar@~/photo.jpg.

Httpie ermittelt automatisch den Datentyp: Wenn key=value übergeben wird, wird der Text als JSON gesendet. Wird Rohtext über --raw übergeben, wird er als Klartext gesendet. Das form-data-Format wird mit dem Flag -f aktiviert.

# POST-Anfrage mit JSON-Daten und einem Header
http POST https://api.example.com/users \
    name="John Doe" \
    email="john@example.com" \
    role:="admin" \
    Authorization:"Bearer test123"

# Antwort mit Hervorhebung und Pretty-print
HTTP/1.1 201 Created
Content-Type: application/json
{
    "id": 42,
    "name": "John Doe"
}

Arbeiten mit JSON und Dateien

Die JSON-Serialisierung in Httpie funktioniert automatisch: Ein als key=value übergebener Wert wird zu einem String-Feld des JSON. Für Zahlen und boolesche Werte wird key:=value verwendet. Verschachtelte Objekte werden mit Punktnotation erstellt: address.city=Moscow.

Hochladen von Dateien und Binärdaten

Httpie unterstützt das multipart/form-data-Format zum Hochladen von Dateien und Daten über die key@path-Syntax. Soll der Dateiinhalt als Rohtext der Anfrage gesendet werden, wird eine Eingabeumleitung verwendet: http POST example.com < file.json. Zum Herunterladen der Antwort in eine Datei wird das Flag -d (download) verwendet.

# Senden von JSON aus einer Datei
http POST https://api.example.com/users < user.json

# Hochladen einer Datei über multipart
http -f POST https://api.example.com/upload \
    photo@~/photo.jpg \
    description="Profile photo"

Verwaltung von Sitzungen und Cookies

Sitzungen in Httpie speichern den Zustand zwischen Anfragen: Cookies, Header und Authentifizierungsparameter. Eine Sitzung wird mit dem Flag --session=name erstellt. Die Sitzungsdaten werden in einer JSON-Datei im Ordner ~/.httpie/sessions/ gespeichert. Eine Sitzung mit dem Suffix :readonly wird nach einer Anfrage nicht aktualisiert.

Beispiel für Sitzungstests

Zunächst wird eine POST-Anfrage an /auth/login mit den Anmeldedaten gesendet — der Server gibt ein Sitzungs-Cookie zurück. Alle nachfolgenden Anfragen an geschützte Endpunkte innerhalb derselben Sitzung senden automatisch das gespeicherte Cookie, was das Browserverhalten beim Testen der API einer mobilen App simuliert.

# Schritt 1: Authentifizierung
http --session=app-test POST https://api.example.com/auth/login \
    username="dev" password="secret"

# Schritt 2: Anfrage mit gespeichertem Sitzungs-Cookie
http --session=app-test GET https://api.example.com/users/me

Authentifizierung und Header

Httpie unterstützt alle gängigen Authentifizierungstypen über Flags: -a user:pass für Basic Auth, --auth-type=digest für Digest, --auth-type=bearer TOKEN für Bearer Token. Benutzerdefinierte Header werden als HeaderName:value an beliebiger Stelle im Befehl hinzugefügt.

OAuth 2.0 und Bearer Token

Zum Testen einer API mit OAuth 2.0 wird das Token über den Authorization-Header übergeben. Httpie verwaltet den Lebenszyklus des Tokens nicht auf Kernel-Ebene — das übernimmt ein externes Skript. Der Befehl http --auth-type=bearer --auth="$TOKEN" GET https://api.example.com/resource entspricht der expliziten Angabe des Headers mit dem Token.

Verwendung von Httpie in CI/CD-Skripten

Httpie ist dank null Abhängigkeiten (außer Python) und lesbarer Ausgabe ideal für CI/CD-Pipelines. Befehle sind ohne zusätzliches Parsen gut in Logs lesbar. Das Tool wird über pip installiert und ist in allen gängigen Docker-Images verfügbar, einschließlich Alpine, Ubuntu und den offiziellen CI-Images von Jenkins und GitLab. Das macht Httpie zu einer praktischen Wahl für automatisierte Tests von REST-APIs und Microservices.

Prüfung des Health-Endpunkts beim Deployment

Ein typisches Szenario ist die Prüfung des API-Status nach dem Deployment einer Anwendung. Httpie sendet eine Anfrage an den Health-Endpunkt und beendet sich mit einem Code ungleich null, wenn die Antwort nicht der erwarteten entspricht. Das Flag --check-status gibt bei Statuscodes >= 300 automatisch einen Fehler zurück.

# Health-Check im Deployment-Skript
http --check-status GET https://api.staging.example.com/health
    status:="ok" && \
    echo "API ist gesund" || \
    echo "API-Prüfung fehlgeschlagen"

Erweiterte Funktionen und Plugins von Httpie

Httpie unterstützt Plugins über das Package-Index-System. Plugins fügen neue Authentifizierungstypen, Serialisierungsformate und Transporte hinzu. Die Installation erfolgt über pip: pip install httpie-plugin-name. Nach der Installation wird das Plugin beim nächsten Start von Httpie automatisch aktiviert.

Beliebte Httpie-Plugins

• httpie-jwt-auth — automatisches Abrufen und Aktualisieren von JWT-Tokens über den Refresh-Token-Mechanismus.
• httpie-oauth — Unterstützung von OAuth 2.0 Client Credentials und Authorization-Code-Flow mit automatischem Austausch des Codes gegen ein Token.
• httpie-editor — öffnet den Anforderungstext vor dem Senden in einem Texteditor (vim, nano, VS Code).
• httpie-image — zeigt Bilder aus der Antwort direkt im Terminal an (erfordert kitty oder iTerm2).

Skripterstellung und Ausgabeparsing

Httpie unterstützt jq-ähnliche Filterung über die Option --pretty=format und cURL-kompatible Ausgabe über --print. Das Flag --quiet deaktiviert die farbige Ausgabe für eine bessere Lesbarkeit in CI-Logs. Für die programmatische Verarbeitung der Antwort verwenden Sie das Flag --body, das nur den Antworttext ohne Header ausgibt.

# Extrahieren eines Felds aus einer JSON-Antwort mit jq
http GET https://api.example.com/users/1 | jq '.name'

# Nur den Antworttext ausgeben (ohne Header)
http --body GET https://api.example.com/health

# Stapel-Senden mit verschiedenen Daten aus einer Datei
while read -r line; do
    http POST https://api.example.com/items $line
done < items.txt

Ausgabeformate und Anpassung

Httpie unterstützt Ausgabeformate über das Flag --print: H (Anforderungs-Header), B (Anforderungstext), h (Antwort-Header), b (Antworttext). Die Kombination --print=hb gibt nur die Antwort-Header und den Text aus. Das Flag --pretty=all aktiviert die farbige Formatierung mit Einrückungen.

Benutzerdefinierte Farbschemata

Httpie unterstützt die Anpassung über die Variable HTTPIE_COLORS. Konfigurieren Sie Farben für URL, Header, JSON und Statuscodes. Integrierte Themes sind verfügbar: autumn, borland, fruity, monokai, native, tango für verschiedene Terminals.

Ausgabe im JSON-Format

Für die programmatische Verarbeitung verwenden Sie --body --pretty=none, das rohes JSON zurückgibt. Kompakte Ausgabe ist nützlich zum Weitergeben an jq, sed und andere Parser bei der Automatisierung von API-Tests in Skripten.

Ausgabeformate und Anpassung der Darstellung

Httpie unterstützt mehrere Ausgabeformate über das Flag --print: H (Anforderungs-Header), B (Anforderungstext), h (Antwort-Header), b (Antworttext). Die Kombination --print=hb gibt nur die Antwort-Header und den Text aus, ohne Meta-Informationen zur Verbindung. Das Flag --pretty=all aktiviert die farbige Formatierung mit Einrückungen für die Lesbarkeit.

Benutzerdefinierte Farbschemata

Httpie unterstützt die Farbanpassung über die Umgebungsvariable HTTPIE_COLORS. Sie können Farben für URL, Header, JSON-Schlüssel und Antwort-Statuscodes konfigurieren. Integrierte Themes sind verfügbar: autumn, borland, fruity, monokai, native und tango für verschiedene Terminaltypen und persönliche Vorlieben.

Ausgabe im JSON-Format ohne Formatierung

Für die programmatische Verarbeitung der Ausgabe verwenden Sie die Flag-Kombination --body --pretty=none, die rohes JSON ohne Farben und Einrückungen zurückgibt. Kompakte Ausgabe ist nützlich zum Weitergeben an jq, sed und andere Konsolen-Parser bei der Automatisierung von REST-API-Tests in Shell-Skripten.