Quando utilizzare curl
Utilizza curl per esaminare le risposte HTTP, scaricare una risorsa o chiamare un API dal server. Separa il successo del trasporto dal successo dell'applicazione, imposta timeout ragionevoli e mantieni i token di autenticazione fuori dagli esempi di comandi salvati.
Sintassi
curl [PARAMETERS] URLLe parentesi quadre contrassegnano gli argomenti facoltativi; i puntini di sospensione significano ripetizione. Sostituisci nomi di file di esempio, nomi utente e indirizzi di server con i tuoi valori.
Opzioni e argomenti comuni
Esempi di utilizzo
Controlla le intestazioni del sito
curl -I https://example.comViene effettuata una richiesta di sola intestazione; alcuni servizi lo gestiscono in modo diverso da una normale richiesta di contenuto.
Scarica il file con l'elaborazione degli errori HTTP
curl --fail --location --output ./page.html https://example.comVengono seguiti i reindirizzamenti e il corpo della risposta sostituisce il file locale denominato; Gli stati di errore HTTP causano il fallimento.
Richiesta JSON con limite di tempo
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusViene richiesta una risposta JSON con durata complessiva limitata; l'endpoint deve effettivamente fornire che API.
Note e limitazioni
- Con HTTPS il certificato è verificato di default; non disabilitare il controllo tramite -k senza un motivo separato.
- Non inserire token o password reali nella cronologia dei comandi e non eseguire script scaricati senza verifica.
Domande comuni e risoluzione dei problemi
Perché curl riesce quando il server restituisce una pagina di errore?
Senza l'opzione di errore, la ricezione di una risposta di errore HTTP può comunque essere considerata un trasferimento riuscito. Ispezionare sia lo stato HTTP che lo stato di uscita del comando.
Devo disabilitare la verifica del certificato per correggere HTTPS?
Non ignorare la fiducia come soluzione di routine. Controlla invece il nome host, l'ora del sistema, la catena di certificati del server e la configurazione della CA attendibile.
Ulteriore aiuto
Le opzioni variano in base alla versione e alla distribuzione. Controlla la documentazione installata con questo comando: man curl.