Qu’est-ce que cURL ?

cURL, ou curl, est un outil en ligne de commande qui envoie des requêtes à des serveurs web. Il est fourni avec macOS, Windows 10 et versions ultérieures, ainsi qu’avec la plupart des systèmes Linux, et la documentation des API présente souvent ses exemples sous forme de commandes curl. Dans une commande, -X définit la méthode, -H ajoute un en-tête, -u des identifiants et -d le corps de la requête.

Description de l’outil

Choisissez la Méthode HTTP et saisissez l’URL : la commande cURL apparaît au fil de la saisie, prête à être copiée. Sous Authentification, un Nom d’utilisateur et un Mot de passe deviennent une option -u pour l’authentification basique. Sous En-têtes, cliquez sur Ajouter un en-tête et remplissez la Clé d’en-tête et la Valeur d’en-tête ; un en-tête n’est ajouté à la commande qu’une fois les deux champs remplis.

Les requêtes POST, PUT et PATCH peuvent avoir un corps. Saisissez-le dans Corps de la requête, ou cochez Type de contenu JSON pour l’écrire dans un éditeur JSON : un JSON valide est inséré dans la commande sur une seule ligne, accompagné de l’en-tête Content-Type: application/json.

L’outil se contente de construire la commande. Il n’envoie pas la requête : exécutez donc la commande dans un terminal.

Fonctionnalités

  • Construit des requêtes GET, POST, PUT, PATCH, DELETE, HEAD et OPTIONS
  • Authentification basique et en-têtes personnalisés
  • Un corps de requête en texte brut ou en JSON, le JSON étant placé sur une seule ligne

Exemple

Une requête POST avec un corps JSON et un en-tête contenant un token donne :

curl -X POST "https://api.example.com/items" -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" -d '{"name":"Sunflower","color":"yellow"}'

Astuces

  • La commande est écrite pour un shell Unix comme bash ou zsh, et vos valeurs y sont insérées telles que vous les saisissez. Un guillemet simple dans le corps, ou un guillemet double ou un $ dans un autre champ, peut casser la commande : modifiez donc ces caractères à la main.
  • Pour une requête HEAD, remplacez -X HEAD par -I dans la commande. Avec -X HEAD, curl attend un corps de réponse qui n’arrive jamais.