Constructor de comandos cURL — Construir solicitudes complejas sin memorizar flags

Conoces curl. Lo has usado mil veces. Y sin embargo, cada vez que necesitas enviar un POST con un token Bearer, un cuerpo JSON y una cabecera personalizada, terminas buscando en Google «curl send json body» por la cienava vez. Las banderas no son difíciles — simplemente hay demasiadas.

¿Por qué curl sigue siendo la herramienta de elección para pruebas de API?

curl está disponible en todos lados — Linux, macOS, Windows, contenedores Docker, ejecutores de CI. No necesita una interfaz gráfica, un complemento ni una cuenta. Cuando pegas un comando curl en un terminal, funciona. Por eso sigue siendo el idioma común de las pruebas de API: los equipos comparten fragmentos de curl en Slack, los copian de la documentación y los introducen en scripts de shell sin pensarlo dos veces.

El problema no es curl en sí — es la sintaxis. Las banderas parecen incoherentes. -X POST establece el método. -H añade una cabecera, pero necesitas una bandera por cabecera. -d envía un cuerpo, pero solo si recuerdas que -d también cambia el método a POST automáticamente. -u user:pass maneja autenticación básica, pero los tokens Bearer van en una cabecera. -F es para subidas de formularios. -k omite la verificación de TLS. Después de un tiempo ya no estás probando tu API — estás depurando tu comando curl.

Conoce el Generador de Comandos curl

El Generador de Comandos curl en iotools.cloud te da una interfaz visual para componer comandos curl sin tener que memorizar banderas. Llena los campos y la herramienta escribe el comando para ti — listo para copiar y ejecutar.

Aquí está lo que cubre:

• Método HTTP – GET, POST, PUT, PATCH, DELETE — un solo desplegable, sin -X necesidad.
• URL y parámetros de consulta – Añade parámetros individualmente; el generador los codifica URL y los agrega correctamente.
• Cabeceras de la solicitud – Añade tantas -H cabeceras como necesites, una fila a la vez. Sin codificación manual.
• Autenticación – Cambia entre Ninguna, Autenticación Básica y Token Bearer. El generador inserta automáticamente la bandera o cabecera correcta.
• Cuerpo de la solicitud – Pega JSON bruto, datos de formulario o texto plano. El generador elige el tipo de contenido correcto y la bandera.
• Vista previa del comando – El comando curl final se actualiza instantáneamente mientras escribes. Un clic copia el comando a tu portapapeles.

Sin instalación, sin cuenta, sin límites de velocidad. Abre la herramienta, construye tu solicitud, copia el comando y pégalo en tu terminal.

Ejemplos reales de comandos curl

1. Prueba de una API REST pública

JSONPlaceholder es una API pública gratuita utilizada por desarrolladores para prototipado y pruebas. Aquí cómo obtener un post individual:

curl -X GET "https://jsonplaceholder.typicode.com/posts/1"   -H "Accept: application/json"

En el Generador de Comandos curl: establece el método a GET, introduce la URL, añade una cabecera (Accept: application/json). La vista previa genera el comando anterior. Sin codificación, sin búsqueda de banderas.

2. POST con un cuerpo JSON y un token Bearer

Esta combinación es la que más veces buscan los desarrolladores. Crea un nuevo post en JSONPlaceholder con un token de autenticación:

curl -X POST "https://jsonplaceholder.typicode.com/posts"   -H "Content-Type: application/json"   -H "Authorization: Bearer YOUR_TOKEN_HERE"   -d '{"title":"Test Post","body":"Hello from curl","userId":1}'

En el generador: método = POST, URL rellenada, campo de token Bearer recibe tu token (el generador escribe la Authorization: Bearer cabecera por ti), el campo del cuerpo recibe el JSON. La vista previa muestra el comando exacto anterior. Copia. Pega. Listo.

3. Subida de archivo multipart

Las subidas de archivos requieren -F en lugar de -d, y los desarrolladores mezclan constantemente estos elementos. El tipo de cuerpo "Form Data" del generador lo maneja correctamente:

curl -X POST "https://api.example.com/upload"   -H "Authorization: Bearer YOUR_TOKEN_HERE"   -F "file=@/path/to/file.pdf"   -F "description=My document"

4. Solicitud con autenticación básica

Prueba de un punto final que utiliza autenticación HTTP básica:

curl -X GET "https://api.example.com/protected"   -u "username:password"   -H "Accept: application/json"

Selecciona "Autenticación Básica" en el desplegable de autenticación del generador, introduce tus credenciales — el generador maneja la -u bandera para que nunca codifiques manualmente tus credenciales.

Uso de comandos generados de curl más allá del terminal

Un comando curl que puedes copiar es un comando curl que puedes reutilizar. Aquí es donde los comandos generados ofrecen beneficios más allá de pruebas aisladas:

• Pipeline de CI – Introduce el comando curl en un paso de GitHub Actions o en un job de GitLab CI. Los controles de salud, los desencadenadores de webhooks y las notificaciones de despliegue — curl los maneja todos sin añadir dependencias de SDK a tu pipeline.
• Scripts de shell – Envuelve el comando en una función, sustituye variables con $VAR, y tienes un cliente de API reutilizable en diez líneas de bash.
• Documentación de API – Los ejemplos de curl son el formato universal de documentación. Pega el comando generado en tu README, página de Notion o documento de Confluence. Cualquier lector puede ejecutarlo inmediatamente, independientemente de su idioma o stack.
• Compartir con compañeros – Un comando curl en un mensaje de Slack es más rápido que “instala Postman, importa la colección, configura la variable de entorno”.

Herramientas complementarias para un flujo completo de pruebas de API

Si estás construyendo un flujo más completo de pruebas o integración de API, dos herramientas se combinan bien con el generador de comandos curl:

• Constructor de encabezados de solicitud HTTP – Componer y validar cabeceras HTTP antes de pegarlas en tu comando curl. Útil cuando trabajas con conjuntos complejos de cabeceras, como las peticiones CORS de preflight o esquemas de autenticación personalizados.
• Generador de Firma de API – Algunas APIs (webhooks de AWS, Stripe) requieren solicitudes firmadas con HMAC. Genera la firma correcta y úsala en tu comando curl sin necesidad de cargar un SDK completo.

Comienza a construir

Deja de buscar banderas en medio de una solicitud. El Generador de Comandos cURL te lleva a un comando funcional y listo para copiar en menos de un minuto — sin instalación, sin cuenta, sin fricción. Abre la herramienta, llena los detalles de tu solicitud y copia el comando.

También te puede interesar