Les options utilisées
-X POST-H 'Accept: application/json'--data-raw '…'-gLa méthode n'est écrite que si elle n'est pas GET, la méthode par défaut de cURL. Quand un corps est envoyé, l'outil ajoute l'en-tête Content-Type qui lui correspond, sauf si vous l'avez déjà saisi. Chaque option est placée sur sa ligne, terminée par une barre oblique inverse, pour rester lisible.
Le corps passe par --data-raw plutôt que --data : avec --data, des données qui commencent par « @ » sont lues comme le nom d'un fichier à envoyer. Et quand l'adresse contient des crochets ou des accolades, l'option -g empêche cURL de les lire comme des plages d'adresses à parcourir.
Exemples
curl 'https://api.exemple.fr/v1/articles' -H 'Accept: application/json'
curl -X POST 'https://api.exemple.fr/v1/articles' -H 'Content-Type: application/json' --data-raw '{"titre": "Bonjour"}'
L'outil vérifie que le JSON saisi est valide avant de produire la commande.
Apostrophes et guillemets
Chaque argument est placé entre apostrophes : le terminal n'interprète alors ni les espaces, ni les « $ », ni les « & » qu'il contient. Une apostrophe dans les données s'écrit '\'' : on ferme l'argument, on ajoute une apostrophe protégée, on le rouvre. « l'article » devient ainsi 'l'\''article', écriture que l'outil produit pour vous.
Sous Windows
Les règles d'apostrophes et la barre oblique inverse de fin de ligne sont celles des terminaux Linux et macOS. Sous Windows, lancez la commande dans Git Bash ou WSL. L'invite de commandes attend des guillemets doubles et le caractère ^ en fin de ligne ; dans PowerShell, tapez curl.exe, car curl y désigne une autre commande dans les anciennes versions.
L'erreur fréquente
Une commande cURL copiée dans un ticket, un forum ou un dépôt Git emporte ses en-têtes, jetons compris. Retirez ou remplacez la clé avant de partager la commande, et changez-la si elle a été publiée.
Questions fréquentes
Comment envoyer du JSON avec cURL ?
Avec -X POST, l'en-tête Content-Type: application/json et les données après --data-raw, entre apostrophes : curl -X POST 'https://…' -H 'Content-Type: application/json' --data-raw '{"titre":"Bonjour"}'.
Comment ajouter un jeton d'authentification à cURL ?
Avec un en-tête : -H 'Authorization: Bearer votre-jeton'. Saisissez-le dans le champ des en-têtes ; ni lui, ni l'adresse, ni les données ne sont gardés dans l'adresse de la page.
Quelle différence entre -d, --data et --data-raw ?
-d est la forme courte de --data. --data-raw envoie les données de la même façon, mais sans lire un « @ » initial comme le nom d'un fichier à envoyer. Sans -X, toutes font passer la méthode en POST.
La commande fonctionne-t-elle sous Windows ?
Telle quelle dans Git Bash ou WSL. L'invite de commandes et PowerShell ne traitent pas les apostrophes ni les barres obliques inverses de fin de ligne de la même façon.
Une erreur ? Signalez-la, nous la corrigeons.