cURL Builder
Understand cURL Builder
Construye un comando curl ejecutable — y la llamada fetch() equivalente en JavaScript — a partir de una URL, un método, cabeceras, cuerpo y autenticación.
How it works
El comando se ensambla a partir de opciones y no de texto libre: `-X` fija el método, cada cabecera pasa a ser su propio `-H`, `-d` aporta el cuerpo, `-u` aporta las credenciales básicas y `-L` sigue las redirecciones. Los valores se envuelven en comillas simples y toda comilla simple dentro del cuerpo se escapa como `'\''`, que es la única forma segura de incrustar una en una cadena de shell POSIX. Si aporta un cuerpo sin Content-Type, se añade uno por usted — application/json cuando el cuerpo empieza por `{` o `[`, y text/plain en caso contrario — porque de lo contrario curl usa por defecto application/x-www-form-urlencoded y el servidor malinterpreta su JSON. No se envía nada; la herramienta solo produce texto.
When to use it
- Convertir una petición que diseñó en un formulario en un comando que puede pegar en un terminal, en un trabajo de CI o en un informe de error
- Producir una línea reproducible para un ticket de soporte, donde un comando curl es la forma menos ambigua de describir una petición
- Obtener un esqueleto de fetch() con las cabeceras y el cuerpo ya rellenados, para pegarlo en el código de la aplicación
- Documentar un endpoint de API en un README con un ejemplo de copiar y pegar que se ejecuta de verdad
Watch out for
- La salida con comillas simples es sintaxis de shell POSIX. cmd.exe de Windows no trata las comillas simples como delimitadores, así que use Git Bash, WSL o convierta el entrecomillado antes de ejecutarlo allí.
- `-k` desactiva la verificación del certificado TLS de toda la petición. Es una opción de depuración para un certificado autofirmado en una máquina propia, nunca algo que deba quedarse en un script.
- La autenticación básica es Base64, no cifrado. El fragmento de fetch codifica `user:password` con btoa, y cualquiera que lea el comando, el historial del shell o el log de CI tiene la contraseña.
- Un comando generado contiene su token real. Ocúltelo antes de pegarlo en una incidencia, en un chat o en un commit.
Frequently Asked Questions
¿Cómo envío una petición POST con cuerpo JSON en curl?
Use: curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/endpoint. El constructor lo genera automáticamente cuando elige el método POST, añade la cabecera Content-Type y pega su cuerpo JSON.
¿Cómo añado cabeceras de autenticación en curl?
Para un token Bearer: -H "Authorization: Bearer SU_TOKEN". Para autenticación básica: -u usuario:contraseña (curl lo codifica automáticamente como una cabecera Authorization en Base64) o -H "Authorization: Basic BASE64". El constructor tiene una sección de autenticación para ambas.
¿Cómo convierto curl a código de Python, JavaScript o Go?
Esta herramienta genera la llamada fetch() equivalente en JavaScript. Para otros lenguajes, use la salida de curl: es el formato HTTP más universal. Herramientas como curlconverter.com convierten comandos curl a muchos lenguajes si los necesita.
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.