Httpie: co to je, HTTP klient pro příkazový řádek

Co je Httpie a čím se liší od cURL

Httpie (nebo HTTPie) — konzolový nástroj napsaný v Pythonu, který zjednodušuje odesílání HTTP požadavků ve srovnání s cURL. Hlavní rozdíl je syntaxe blízká přirozenému jazyku: argumenty se oddělují mezerami, hlavičky se uvádějí dvojtečkou a data JSON — znaménkem rovnosti, bez nutnosti escapovat uvozovky.

Srovnání cURL a Httpie

Stejný POST požadavek v cURL vyžaduje nejméně tři přepínače (-X, -H, -d) a ruční escapování JSON. Httpie udělá totéž třemi slovy bez přepínačů, automaticky nastaví Content-Type: application/json a obarví výstup. Odpověď se ve výchozím nastavení formátuje s odsazením a zvýrazněním syntaxe.

Syntaxe požadavků v Httpie

Httpie používá jednotný formát příkazového řádku bez přepínačů pro základní parametry. Metoda HTTP se uvádí jako první argument (GET, POST, PUT, DELETE, PATCH), URL — jako druhý. Pokud je metoda vynechána, Httpie automaticky zvolí GET (pro požadavky bez těla) nebo POST (s tělem).

Typy argumentů

• Header:Value — hlavičky požadavku s dvojtečkou, bez mezery za dvojtečkou: Authorization:"Bearer token".
• key=value — pole objektu JSON v těle požadavku: name=John age=30.
• key:=value — hodnoty JSON, které nejsou řetězci (čísla, logické hodnoty, pole): active:=true tags:=["dev","test"].
• key@file — načtení hodnoty ze souboru: avatar@~/photo.jpg.

Httpie automaticky určí typ dat: pokud je předán key=value — tělo se odesílá jako JSON. Pokud je předán surový text přes --raw — jako prostý text. Formát form-data se aktivuje přepínačem -f.

# POST požadavek s daty JSON a hlavičkou
http POST https://api.example.com/users \
    name="John Doe" \
    email="john@example.com" \
    role:="admin" \
    Authorization:"Bearer test123"

# Odpověď se zvýrazněním a Pretty-print
HTTP/1.1 201 Created
Content-Type: application/json
{
    "id": 42,
    "name": "John Doe"
}

Práce s JSON a soubory

JSON serializace v Httpie funguje automaticky: hodnota předaná jako key=value se stane řetězcovým polem JSON. Pro čísla a logické hodnoty se používá key:=value. Vnořené objekty se vytvářejí tečkovou notací: address.city=Moscow.

Nahrávání souborů a binárních dat

Httpie podporuje formát multipart/form-data pro nahrávání souborů a dat pomocí syntaxe key@path. Pokud je třeba odeslat obsah souboru jako surové tělo požadavku, používá se přesměrování vstupu: http POST example.com < file.json. Pro stažení odpovědi do souboru se používá přepínač -d (download).

# Odeslání JSON ze souboru
http POST https://api.example.com/users < user.json

# Nahrání souboru přes multipart
http -f POST https://api.example.com/upload \
    photo@~/photo.jpg \
    description="Profile photo"

Správa relací a cookies

Relace v Httpie ukládají stav mezi požadavky: cookies, hlavičky a parametry ověřování. Relace se vytváří přepínačem --session=name. Data relace se ukládají do souboru JSON ve složce ~/.httpie/sessions/. Relace s příponou :readonly se po požadavku neaktualizuje.

Příklad testování relace

Nejprve se provede POST na /auth/login s přihlašovacími údaji — server vrátí cookie relace. Všechny další požadavky na chráněné koncové body v rámci stejné relace automaticky odesílají uloženou cookie, což simuluje chování prohlížeče při testování API mobilní aplikace.

# Krok 1: ověřování
http --session=app-test POST https://api.example.com/auth/login \
    username="dev" password="secret"

# Krok 2: požadavek s uloženou cookie relace
http --session=app-test GET https://api.example.com/users/me

Ověřování a hlavičky

Httpie podporuje všechny hlavní typy ověřování pomocí přepínačů: -a user:pass pro Basic Auth, --auth-type=digest pro Digest, --auth-type=bearer TOKEN pro Bearer Token. Vlastní hlavičky se přidávají jako HeaderName:value na libovolné místo příkazu.

OAuth 2.0 a Bearer Token

Pro testování API s OAuth 2.0 se token předává přes hlavičku Authorization. Httpie neřídí životní cyklus tokenu na úrovni jádra — to dělá externí skript. Příkaz http --auth-type=bearer --auth="$TOKEN" GET https://api.example.com/resource je ekvivalentem explicitního uvedení hlavičky s tokenem.

Použití Httpie ve skriptech CI/CD

Httpie se díky nulovým závislostem (kromě Pythonu) a čitelnému výstupu skvěle hodí pro pipeline CI/CD. Příkazy se snadno čtou v protokolech bez dalšího parsování. Nástroj se instaluje přes pip a je dostupný ve všech oblíbených Docker obrazech, včetně Alpine, Ubuntu a oficiálních obrazů CI systémů Jenkins a GitLab. Díky tomu je Httpie vhodnou volbou pro automatizované testování REST API a mikroslužeb.

Kontrola health koncového bodu při nasazení

Typický scénář — kontrola stavu API po nasazení aplikace. Httpie odešle požadavek na health koncový bod a skončí s nenulovým kódem, pokud odpověď neodpovídá očekávané. Přepínač --check-status automaticky vrací chybu při stavovém kódu >= 300.

# Health check ve skriptu nasazení
http --check-status GET https://api.staging.example.com/health
    status:="ok" && \
    echo "API je v pořádku" || \
    echo "Kontrola API selhala"

Pokročilé možnosti a pluginy Httpie

Httpie podporuje pluginy přes systém Package Index. Pluginy přidávají nové typy ověřování, formáty serializace a transporty. Instalace probíhá přes pip: pip install httpie-plugin-name. Po instalaci se plugin automaticky aktivuje při příštím spuštění Httpie.

Oblíbené pluginy Httpie

• httpie-jwt-auth — automatické získávání a obnovování tokenů JWT přes mechanismus refresh token.
• httpie-oauth — podpora OAuth 2.0 Client Credentials a toku Authorization Code s automatickou výměnou kódu za token.
• httpie-editor — otevře tělo požadavku v textovém editoru (vim, nano, VS Code) před odesláním.
• httpie-image — zobrazí obrázky z odpovědi přímo v terminálu (vyžaduje kitty nebo iTerm2).

Skriptování a parsování výstupu

Httpie podporuje filtrování podobné jq přes volbu --pretty=format a výstup kompatibilní s cURL přes --print. Přepínač --quiet vypíná barevný výstup pro lepší čitelnost v protokolech CI. Pro programové zpracování odpovědi použijte přepínač --body, který zobrazuje pouze tělo odpovědi bez hlaviček.

# Extrakce pole z odpovědi JSON pomocí jq
http GET https://api.example.com/users/1 | jq '.name'

# Zobrazení pouze těla odpovědi (bez hlaviček)
http --body GET https://api.example.com/health

# Dávkové odeslání s různými daty ze souboru
while read -r line; do
    http POST https://api.example.com/items $line
done < items.txt

Formáty výstupu a přizpůsobení

Httpie podporuje formáty výstupu přes přepínač --print: H (hlavičky požadavku), B (tělo požadavku), h (hlavičky odpovědi), b (tělo odpovědi). Kombinace --print=hb zobrazí pouze hlavičky a tělo odpovědi. Přepínač --pretty=all zapíná barevné formátování s odsazením.

Vlastní barevná schémata

Httpie podporuje přizpůsobení přes proměnnou HTTPIE_COLORS. Nastavte barvu pro URL, hlavičky, JSON a stavové kódy. K dispozici jsou vestavěná témata: autumn, borland, fruity, monokai, native, tango pro různé terminály.

Výstup ve formátu JSON

Pro programové zpracování použijte --body --pretty=none, které vrací surový JSON. Kompaktní výstup je užitečný pro předání do jq, sed a dalších parserů při automatizaci testování API ve skriptech.

Formáty výstupu a přizpůsobení vzhledu

Httpie podporuje několik formátů výstupu přes přepínač --print: H (hlavičky požadavku), B (tělo požadavku), h (hlavičky odpovědi), b (tělo odpovědi). Kombinace --print=hb zobrazí pouze hlavičky a tělo odpovědi, s vyloučením metainformací o připojení. Přepínač --pretty=all zapíná barevné formátování s odsazením pro čitelnost.

Vlastní barevná schémata

Httpie podporuje přizpůsobení barev přes proměnnou prostředí HTTPIE_COLORS. Můžete nastavit barvu pro URL, hlavičky, klíče JSON a stavové kódy odpovědi. K dispozici jsou vestavěná témata: autumn, borland, fruity, monokai, native a tango pro různé typy terminálů a osobní preference.

Výstup ve formátu JSON bez formátování

Pro programové zpracování výstupu použijte kombinaci přepínačů --body --pretty=none, která vrací surový JSON bez barev a odsazení. Kompaktní výstup je užitečný pro předání do jq, sed a dalších konzolových parserů při automatizaci testování REST API v shell skriptech.