Obtenez la commande curl et le code fetch

Développeurs API et équipes support s’en servent pour reproduire un appel avant un test, un diagnostic ou un exemple de documentation.

Obtenez la commande curl et le code fetch. Vous repartez avec une sortie exploitable, sans créer de compte ni envoyer votre saisie.

Mode d’emploi

Écrivez la méthode HTTP sur la première ligne, par exemple GET ou POST.
Indiquez ensuite l'URL de l'API ou du service à appeler.
Ajoutez un en-tête par ligne au format Nom : valeur, puis séparez le corps par une ligne contenant deux tirets.
Lancez la composition pour obtenir la commande curl et le code fetch correspondants.
Copiez la sortie et testez-la dans votre terminal ou votre projet.

Exemple

Un développeur prépare un exemple pour la documentation d'une API. Il saisit une méthode POST, une adresse de test, un en-tête Content-Type et un petit corps JSON. L'outil affiche la commande curl et le code fetch, ce qui permet de vérifier que la requête contient bien les mêmes éléments avant de la publier.

Entrée

POST
https://example.com/api/items
Content-Type: application/json
--
{"name":"test"}

Résultat

# curl
curl -X POST 'https://example.com/api/items' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"test"}'

// fetch
const reponse = await fetch("https://example.com/api/items", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\"name\":\"test\"}"
});
if (!reponse.ok) throw new Error('HTTP ' + reponse.status);
const donnees = await reponse.json();

--- 1 en-tete(s), corps de 15 caractere(s).
Le controle de reponse.ok n est pas decoratif : fetch ne rejette PAS sur un 404 ni sur un 500, il resout normalement.

Limites et formats

L'outil ne contacte pas l'API : il produit seulement le texte de la requête.
Une méthode ou une URL mal orthographiée donnera une commande inutilisable ; relisez avant de copier.
Les en-têtes doivent respecter le format Nom : valeur, un par ligne.
Les fichiers importés servent à préparer l'entrée ; vérifiez que leur contenu ne contient pas de secret.

Où le traitement a lieu

Tout est calculé dans votre navigateur. La méthode, l'URL, les en-têtes et le corps restent sur votre appareil et ne sont envoyés à aucun service distant.

Questions fréquentes

Puis-je utiliser l'URL de mon API interne ?

Oui, car le texte reste dans votre navigateur et n'est pas appelé par l'outil. Vous pouvez donc préparer une requête vers une adresse locale ou privée, puis l'exécuter vous-même depuis votre environnement autorisé.

Pourquoi le corps doit-il être séparé par une ligne de tirets ?

Cette ligne indique à l'outil où s'arrête la liste des en-têtes et où commence le corps. Sans elle, le contenu risque d'être interprété comme un en-tête supplémentaire et la requête générée sera incorrecte.

La commande curl et le code fetch sont-ils équivalents ?

Ils décrivent le même appel avec des syntaxes différentes. curl s'utilise dans un terminal, tandis que fetch s'intègre à du JavaScript. Vérifiez les en-têtes et le corps dans les deux sorties avant de les réutiliser.