Convertisseur de cURL en code
Convertissez une commande curl en code JavaScript utilisant fetch ou Axios, ou en code Python utilisant Requests, en conservant la méthode, les en-têtes, les cookies, l’authentification et le corps de la requête. L’outil s’exécute dans votre navigateur.
Entrée
Sortie
Documentation
À quoi sert cet outil ?
Le convertisseur cURL vers code transforme une commande curl en code qui envoie la même requête HTTP depuis votre propre programme. Il génère trois types de code :
- JavaScript (fetch) : l’API fetch intégrée aux navigateurs, à Deno, Bun et Node.js.
- Node.js (Axios) : la bibliothèque Axios, très répandue, avec les modules Node.js pour les fichiers et les paramètres TLS.
- Python (Requests) : la bibliothèque Requests.
Les outils de développement de votre navigateur sont un moyen courant d’obtenir une commande : dans le panneau Réseau, faites un clic droit sur une requête et choisissez « Copier en tant que cURL ». La documentation des API présente souvent aussi des exemples sous forme de commandes curl.
Comment l’utiliser
- Collez la commande curl. Les commandes longues peuvent s’étendre sur plusieurs lignes, avec une barre oblique inverse à la fin de chaque ligne, comme le prévoient les shells.
- Choisissez le langage.
- Copiez le code ou téléchargez-le dans un fichier (
request.mjspour JavaScript,request.pypour Python).
Le code est mis à jour au fur et à mesure de votre saisie. Si la commande contient une erreur qui empêcherait curl de fonctionner, comme un guillemet non fermé ou une option inconnue, l’outil vous l’indique.
Éléments convertis
- La méthode, y compris celles que curl choisit automatiquement :
-det-Fdéfinissent une requête POST,-Iune requête HEAD et-Tune requête PUT. - L’URL, avec les paramètres de requête ajoutés par
-Gou--url-query. - Les en-têtes définis par
-H, l’agent utilisateur défini par-A, le référent défini par-eet les cookies définis par-b, qui deviennent un dictionnairecookiesen Python. - L’authentification de base définie par
-uou présente dans l’URL, en utilisant la méthode propre à chaque bibliothèque, ainsi que les tokens Bearer définis par--oauth2-bearer. Python prend également en charge l’authentification Digest. - Les corps de requête : le JSON défini par
--jsonou par un type de contenu JSON devient un objet ou un dictionnaire ; les données de formulaire définies par-ddeviennent un objetURLSearchParamsou un dictionnaire ; et les formulaires multiparties définis par-Fdeviennent un objetFormDataou un dictionnairefiles, avec les fichiers téléversés. - Le délai d’expiration défini par
--max-time(et--connect-timeouten Python),-kpour ignorer les vérifications TLS, les certificats d’autorité de certification et client, ainsi qu’un proxy défini par-x.
Les en-têtes que curl ajoute lui-même, comme son propre User-Agent, Accept: */* et Content-Length, sont omis, car les bibliothèques ajoutent les leurs. Les options qui modifient uniquement l’affichage de la réponse par curl, comme -s ou -v, sont également omises.
Éléments impossibles à convertir
Certains éléments n’ont pas d’équivalent dans une bibliothèque ou un langage. Ils sont alors ajoutés en commentaires en haut du code, afin que rien ne soit omis sans avertissement :
- Les options sans équivalent, comme
--retry, sont répertoriées sous la mention « Non converti ». - fetch ne peut pas ignorer les vérifications TLS, utiliser un proxy ni définir un délai d’expiration de connexion. De plus, les navigateurs ne permettent pas aux scripts de définir l’en-tête Cookie, contrairement à Node.js.
- Les fichiers lus par curl, comme
-d @data.jsonou-F photo=@cat.jpg, sont lus sur le disque avec Node.js et Python. En JavaScript dans un navigateur, ils sont remplacés par un espace réservé que vous devez remplacer, par exemple par un fichier provenant d’un élément<input type="file">. - Lorsqu’une commande envoie plusieurs requêtes, le code généré correspond à la première.
Exemples
curl https://example.com/devientrequests.get("https://example.com/")en Python.curl -u ada:secret https://api.example.com/medevientauth=("ada", "secret")en Python et une optionauthavec Axios.curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersdevientjson={"item": "sourdough loaf"}en Python etJSON.stringify({ item: "sourdough loaf" })avec fetch.
Fonctionnement
La commande est lue comme le feraient un shell et curl, en tenant compte des guillemets, des caractères d’échappement et des continuations de ligne, par le même analyseur que celui utilisé par le validateur de commandes cURL du site. Le code généré représente ensuite la requête que curl enverrait. Tout se passe dans votre navigateur : les commandes contenant des tokens ou des mots de passe ne quittent donc jamais votre appareil.
Fonctionnalités
- JavaScript fetch, Node.js Axios et Python Requests
- En-têtes, cookies, authentification de base et Bearer
- Corps JSON, de formulaire, multiparties et contenant des fichiers
- Délais d’expiration, options TLS, certificats et proxys
- Commentaires pour tout élément impossible à convertir
- Messages clairs en cas d’erreur dans la commande
- Copie ou téléchargement du code
- Exécution dans votre navigateur