cURL Builder
Understand cURL Builder
Construit une commande curl exécutable — ainsi que l'appel fetch() JavaScript équivalent — à partir d'une URL, d'une méthode, d'en-têtes, d'un corps et d'une authentification.
How it works
La commande est assemblée à partir d'options plutôt que de texte libre : `-X` définit la méthode, chaque en-tête devient son propre `-H`, `-d` fournit le corps, `-u` fournit les identifiants Basic et `-L` suit les redirections. Les valeurs sont entourées d'apostrophes et toute apostrophe présente dans le corps est échappée en `'\''`, seule façon sûre d'en insérer une dans une chaîne de shell POSIX. Si vous fournissez un corps sans Content-Type, l'outil en ajoute un — application/json quand le corps commence par `{` ou `[`, text/plain sinon — car curl retomberait sinon sur application/x-www-form-urlencoded et le serveur lirait votre JSON de travers. Rien n'est envoyé ; l'outil ne produit que du texte.
When to use it
- Transformer une requête conçue dans un formulaire en une commande à coller dans un terminal, une tâche de CI ou un rapport de bug
- Produire une ligne de commande reproductible pour un ticket de support, où une commande curl est la façon la moins ambiguë de décrire une requête
- Obtenir un squelette fetch() avec les en-têtes et le corps déjà renseignés, à coller dans du code applicatif
- Documenter un point d'accès d'API dans un README avec un exemple à copier-coller qui fonctionne réellement
Watch out for
- La sortie entre apostrophes relève de la syntaxe du shell POSIX. cmd.exe sous Windows ne traite pas du tout les apostrophes comme des délimiteurs — utilisez Git Bash, WSL, ou convertissez les délimiteurs avant de l'exécuter là-bas.
- `-k` désactive la vérification du certificat TLS pour toute la requête. C'est une option de débogage pour un certificat auto-signé sur une machine qui vous appartient, jamais quelque chose à laisser dans un script.
- L'authentification Basic est du Base64, pas du chiffrement. L'extrait fetch encode `user:password` avec btoa, et quiconque lit la commande, l'historique du shell ou le journal de CI dispose du mot de passe.
- Une commande générée contient votre vrai jeton. Masquez-le avant de la coller dans un ticket, une discussion ou un commit.
Frequently Asked Questions
Comment envoyer une requête POST avec un corps JSON en curl ?
Utilisez : curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/endpoint. Le constructeur génère cela automatiquement dès que vous choisissez la méthode POST, ajoutez l'en-tête Content-Type et collez votre corps JSON.
Comment ajouter des en-têtes d'authentification en curl ?
Pour un jeton Bearer : -H "Authorization: Bearer YOUR_TOKEN". Pour l'authentification Basic : -u utilisateur:motdepasse (curl l'encode automatiquement en un en-tête Authorization Base64) ou -H "Authorization: Basic BASE64_ENCODED". Le constructeur propose une section d'authentification pour les deux.
Comment convertir une commande curl en Python, JavaScript ou Go ?
Cet outil génère l'appel fetch() JavaScript équivalent. Pour les autres langages, servez-vous de la sortie curl — c'est le format HTTP le plus universel. Des outils comme curlconverter.com convertissent les commandes curl vers de nombreux langages si vous en avez besoin.
How to Use cURL Builder
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.