Réseau et accès à distance

Commande curl

Envoyer des requêtes HTTP et télécharger des données

Linux · Exemples Bash · commandes exécutées sur le serveur sélectionné

Quand utiliser curl

Utilisez curl pour inspecter les réponses HTTP, télécharger une ressource ou appeler un API depuis le serveur. Séparez le succès du transport du succès de l'application, définissez des délais d'attente raisonnables et conservez les jetons d'authentification hors des exemples de commandes enregistrés.

Syntaxe

curl [PARAMETERS] URL

Les crochets marquent les arguments facultatifs ; une ellipse signifie une répétition. Remplacez les exemples de noms de fichiers, de noms d'utilisateur et d'adresses de serveur par vos propres valeurs.

Options et arguments courants

-I
Demandez uniquement les en-têtes HTTP, à l’aide de la méthode HEAD.
-f
Renvoie une erreur pour les codes d’état HTTP 400 et supérieurs.
-L
Suivez les redirections ; -o spécifie le fichier de résultat.

Exemples d'utilisation

Vérifier les en-têtes du site

curl -I https://example.com

Une demande d'en-tête uniquement est effectuée ; certains services gèrent cela différemment d'une demande de contenu normale.

Télécharger le fichier avec traitement des erreurs HTTP

curl --fail --location --output ./page.html https://example.com

Les redirections sont suivies et le corps de la réponse remplace le fichier local nommé ; Les états d'erreur HTTP provoquent un échec.

Demander JSON avec limite de temps

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Une réponse JSON est demandée avec une durée globale bornée ; le point de terminaison doit réellement fournir ce API.

Remarques et limites

  • Avec HTTPS le certificat est vérifié par défaut ; ne désactivez pas la vérification via -k sans raison distincte.
  • Ne placez pas de vrais jetons ou mots de passe dans l'historique des commandes et n'exécutez pas de scripts téléchargés sans vérification.

Questions courantes et dépannage

Pourquoi curl réussit-il lorsque le serveur renvoie une page d'erreur ?

Sans l'option d'échec, la réception d'une réponse d'erreur HTTP peut toujours être considérée comme un transfert réussi. Inspectez à la fois l’état du HTTP et l’état de sortie de la commande.

Dois-je désactiver la vérification du certificat pour corriger HTTPS ?

Ne contournez pas la confiance comme solution de routine. Vérifiez plutôt le nom d'hôte, l'heure système, la chaîne de certificats du serveur et la configuration de l'autorité de certification approuvée.

Aide supplémentaire

Les options varient selon la version et la distribution. Vérifiez la documentation installée avec cette commande : man curl.