Hogyan használhatja a HTTPie-t az API-kkal való interakcióhoz a terminálról


Képernyőkép a HTTPie-kérelem mintájáról

HTTPie ez egy HTTP kliens a termináljához. A |_+_| modern alternatívájaként tervezett HTTPie egyszerű szintaxist és automatikusan formázott kimenetet kínálva megkönnyíti az API-kkal való interakciót.

Elérhető Windows, Mac és Linux rendszeren, kapja meg a telepítést Egyszerű ügynek kell lennie. A legtöbb Linux-disztribúció most már tartalmazza a HTTPie-t a csomagtárolóiban, így gyorsan |_+_|, |_+_| vagy |_+_| kezdeni. A Homebrew-n keresztül is elérhető Mac-felhasználók számára, valamint Python-csomagként, amelyet Pip-en keresztül szállítanak ki mindhárom platformon (|_+_|).



A telepítés után a HTTPie regisztrálja a fájlt |_+_| az |_+_| parancsokat a héjában. Mostantól egyszerűen és kifejező módon hívhat API-végpontokat anélkül, hogy elhagyná a terminált!

alapvető parancsokat

A legegyszerűbb formájában a HTTPie-nek átadható egy URL-cím, amellyel azonnal létrehozhat egy fájlt |_+_| kérés:

|_+_|

Az adatok elküldéséhez adja meg a megfelelő HTTP igét, majd adja át a kulcs/érték párokat további parancssori paraméterekként:

|_+_|

Alapértelmezés szerint az adatokat JSON-ként küldi el a rendszer a megfelelő kérésfejlécekkel. Ha űrlapként szeretné elküldeni, adja át a |_+_| paraméter.

JSON-szintaxis használatakor ne feledje, hogy az összes mezőt általában karakterláncként küldi el. Használhatja a |_+_| fájlt szintaxis |_+_| helyett nyers adat módba váltáshoz. Egy paraméter |_+_| akkor |_+_| lesz az eredmény kulcsot egy két egész számból álló tömbre állítva.

Fejlécek és sütik

A kérés fejlécének beállításához adja meg a fejléc nevét és értékét kettősponttal elválasztott karakterláncként:

|_+_|

A HTTPie alapértelmezés szerint beállít néhány fejlécet, például |_+_|. Ezek eltávolíthatók, ha kifejezetten üres értékkel adjuk meg őket.

A cookie-k beállítása a cookie-kat tartalmazó karakterlánc kettősponttal elválasztott értékként történő megadásával történik:

|_+_|

Valójában ez csak egy speciális esete a |_+_| beállításnak fejlécet, amely a cookie-k HTTP-n keresztüli küldésének módja.

fájlokkal dolgozni

Fájlokat normál shell-átirányításokkal tölthet fel és tölthet le:

|_+_|

Fájlokat is feltölthet HTTP-űrlap beküldése részeként a |_+_| használatával szintaxis:

|_+_|

Ez ugyanúgy működik, mint a |_+_| jelű HTML-fájl bevitele. Ehelyett betölthet adatokat egy fájlból, és beágyazhatja azokat a kérésbe a |_+_| használatával kiterjesztés. szintaxis, |_+_| helyett.

üléseken

A HTTPie beépített támogatással rendelkezik az állandó munkamenetekhez. Ezek lehetővé teszik a kérésösszetevők, például a HTTP-fejlécek és a cookie-k újrafelhasználását az ugyanahhoz a gazdagéphez intézett kérések között.

A |_+_| kiterjesztés konfigurálásával munkameneteket hozhat létre és használhat paraméter. Értékként adja meg az új munkamenet tárolására használt fájl elérési útját.

|_+_|

A munkamenettel kompatibilis adatok, például |_+_| az előző kérés fejléce most mentésre kerül a fájlba. Későbbi kérések esetén most kihagyhatja a |_+_| fájlt fejléc: a munkamenetben meghatározottak szerint automatikusan szerepelni fog.

A munkamenetfájl megadása helyett használhat egy egyszerű nevet is (|_+_|). Ebben az esetben a HTTPie automatikusan elmenti a munkamenetet egy belsőleg kezelt fájlba. Minden munkamenet ahhoz a gazdagéphez van kötve, amelyről származott, tehát |_+_| az |_+_| Egymástól függetlenül fognak létezni.

output menedzsment

A HTTPie egyik jelentős fejlesztése az olyan segédprogramokhoz képest, mint a |_+_| az automatikus válaszadó formázása. A JSON-törzsek kezelése különösen jól működik, megfelelő behúzással, az objektumok ábécé szerinti rendezésével a kulcsok alapján, valamint a Unicode-karakterek megfelelő átalakításával.

Néhány különböző beállítás segítségével testreszabhatja a kimenet megjelenítését. a |_+_| a zászlót a következőre lehet állítani: |_+_| (alapértelmezett), |_+_| (csak színek), |_+_| (csak formázás) vagy |_+_| (az összes kimeneti feldolgozás letiltásához és a nyers adatok megtekintéséhez).

Ezenkívül megváltoztathatja a színsémát a |_+_| használatával zászló. A rendelkezésre álló sémák: |_+_| (az alapértelmezett érték), |_+_| (használja az alábbi Pygments könyvtár stílusait), |_+_| és a népszerű |_+_|.

Nem kell aggódnia az alapértelmezett formátum miatt, amikor a kimenetet fájlba irányítja át. A HTTPie felismeri, hogy át van irányítva, és formázás nélkül egyszerűen átirányítja a nyers adatokat. Ez azt is jelenti, hogy a bináris válaszokat, amelyeket általában soha nem küldenek el a terminálnak, fájlba lehet továbbítani.

Konfigurációs fájl

A HTTPie egy alapvető konfigurációs fájlt támogat, amely az alapértelmezett beállítások meghatározásához használható. Ezek az Ön által benyújtott összes kérésre vonatkoznak. A fájlt a |_+_| mappába kell menteni Linux / Mac rendszeren és |_+_| Windows rendszeren.

Egyetlen konfigurációs kulcs támogatott, |_+_|, amely számos alapvető paramétert elfogad a futtatott HTTPie-parancsokhoz való hozzáadáshoz:

|_+_|

Bármelyik, a HTTPie parancssori felület által támogatott opció beépíthető. Az alapértelmezett beállításokat felülírhatja, ha a HTTPie minden egyes futtatásakor új értékre állítja őket.

következtetés

HTTPie egy funkciókban gazdag eszköz, amely HTTP API-kat juttat el a terminálhoz. Ez egy modern alternatíva az olyan Unix kapcsokhoz, mint a |_+_| fejlesztők és tesztelők általi rendszeres használatra tervezték. Bár a szintaxis néha kínos lehet, általában kifejező és emlékezetes.

Érdemes időt szánni a hivatalos dokumentáció ha többet szeretne megtudni a HTTPie-ről. Minden fejlesztés a szabadban történik GitHub ban nyújtott támogatással Rács ez verem túlcsordulás .

Mit gondolsz?