Kdy použít curl
Použijte curl ke kontrole odpovědí HTTP, stažení zdroje nebo volání API ze serveru. Oddělte úspěšnost přenosu od úspěchu aplikace, nastavte rozumné časové limity a udržujte ověřovací tokeny mimo uložené příklady příkazů.
Syntaxe
curl [PARAMETERS] URLHranaté závorky označují volitelné argumenty; elipsa znamená opakování. Nahraďte vzorové názvy souborů, uživatelská jména a adresy serverů svými vlastními hodnotami.
Společné možnosti a argumenty
Příklady použití
Zkontrolujte záhlaví stránek
curl -I https://example.comJe proveden požadavek pouze na záhlaví; některé služby to řeší jinak než normální požadavek na obsah.
Stáhnout soubor se zpracováním chyb HTTP
curl --fail --location --output ./page.html https://example.comPřesměrování jsou následována a tělo odpovědi nahradí pojmenovaný místní soubor; Chybové stavy HTTP způsobují selhání.
Vyžádejte si JSON s časovým limitem
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusJe požadována odpověď JSON s omezenou celkovou dobou trvání; koncový bod musí ve skutečnosti poskytovat API.
Poznámky a omezení
- U HTTPS je certifikát standardně ověřen; nezakazujte kontrolu přes -k bez zvláštního důvodu.
- Neumisťujte skutečné tokeny nebo hesla do historie příkazů a nespouštějte stažené skripty bez ověření.
Běžné otázky a odstraňování problémů
Proč curl uspěje, když server vrátí chybovou stránku?
Bez možnosti selhání může být přijetí chybové odpovědi HTTP stále považováno za úspěšný přenos. Zkontrolujte stav HTTP i stav ukončení příkazu.
Mám zakázat ověřování certifikátu, abych opravil HTTPS?
Nevynechávejte důvěru jako rutinní opravu. Místo toho zkontrolujte název hostitele, systémový čas, řetězec certifikátů serveru a konfiguraci důvěryhodného CA.
Další pomoc
Možnosti se liší podle verze a distribuce. Zkontrolujte nainstalovanou dokumentaci pomocí tohoto příkazu: man curl.