Convertidor de cURL a Código

Cómo Usar el Convertidor de cURL a Código

Pegue un comando cURL en el área de entrada, seleccione su lenguaje de programación de destino del menú desplegable y haga clic en Convertir. La herramienta analiza el comando cURL para extraer el método HTTP, la URL, los encabezados y el cuerpo de la solicitud, luego genera código equivalente usando la biblioteca HTTP estándar del lenguaje seleccionado. El panel de estadísticas muestra el método analizado, la URL, el conteo de encabezados y si hay un cuerpo presente. Use el botón Copiar para copiar el código generado a su portapapeles.

Esta herramienta es invaluable para desarrolladores que prueban APIs con cURL y luego necesitan integrar esas solicitudes en el código de su aplicación. Las herramientas de desarrollo del navegador le permiten copiar cualquier solicitud de red como un comando cURL, facilitando capturar una solicitud funcional y convertirla a código en el lenguaje de su elección.

Entendiendo los Comandos cURL

cURL es el cliente HTTP de línea de comandos más utilizado, instalado por defecto en prácticamente todos los sistemas operativos. Un comando cURL consiste en la palabra clave curl seguida de una URL y opciones opcionales. La opción -X especifica el método HTTP (GET, POST, PUT, DELETE, etc.). La opción -H agrega encabezados de solicitud como Content-Type y Authorization. La opción -d envía datos en el cuerpo de la solicitud. La opción -u proporciona credenciales de autenticación básica.

Cuando no se especifica explícitamente un método, cURL usa GET por defecto. Cuando se usa la opción -d sin -X, cURL cambia automáticamente a POST. Estos comportamientos implícitos se preservan en el código generado, que establece explícitamente el método para hacer clara la intención independientemente de los valores predeterminados específicos del lenguaje.

Lenguajes y Bibliotecas Soportados

El convertidor genera código idiomático para cuatro lenguajes populares. El código Python usa la biblioteca requests, que es el estándar de facto para HTTP en Python. El código JavaScript usa la API fetch integrada, que está disponible en todos los navegadores modernos y Node.js. El código Ruby usa Net::HTTP de la biblioteca estándar. El código PHP usa las funciones de cURL (curl_init, curl_setopt, curl_exec), que están disponibles en prácticamente todas las instalaciones de PHP.

Manejo de Autenticación y Encabezados

Las solicitudes de API a menudo requieren autenticación. El convertidor maneja autenticación con token Bearer pasada mediante -H 'Authorization: Bearer ...', autenticación Basic mediante -u usuario:contraseña y encabezados de clave de API. Los encabezados personalizados se traducen al mecanismo apropiado de configuración de encabezados para cada lenguaje. Los encabezados Content-Type se preservan para asegurar que el cuerpo de la solicitud se envíe en el formato correcto, ya sea JSON, codificado en formulario o multiparte.

Entendiendo las Opciones de cURL

cURL ofrece docenas de opciones de línea de comandos, pero un puñado representa la gran mayoría del uso en el mundo real. Aprender qué hace cada una le ayuda a leer y escribir comandos cURL con confianza, y entenderlas facilita verificar que el código convertido sea correcto.

Opciones de Solicitud

La opción -X (o --request) establece el método HTTP. Los valores comunes son GET, POST, PUT, PATCH y DELETE. Si omite -X completamente, cURL usa GET por defecto a menos que esté presente una opción de datos como -d, en cuyo caso cambia a POST automáticamente. La opción -H (o --header) agrega un encabezado personalizado a la solicitud. Puede usarla múltiples veces para establecer varios encabezados: -H 'Content-Type: application/json' -H 'Accept: application/json'. La opción -d (o --data) envía datos en el cuerpo de la solicitud e implica POST. Para cargas JSON típicamente se combina con -H 'Content-Type: application/json'. La variante --data-raw se comporta de manera idéntica pero no interpreta el prefijo @ como una referencia a archivo.

Opciones de Autenticación y Salida

La opción -u (o --user) proporciona credenciales de autenticación Basic en el formato usuario:contraseña. cURL las codifica en Base64 y las envía en el encabezado Authorization. La opción -o (o --output) escribe el cuerpo de la respuesta a un archivo en lugar de la salida estándar. La opción -O guarda a un archivo usando el nombre de archivo remoto de la URL. La opción -v (o --verbose) imprime información detallada de solicitud y respuesta, incluyendo detalles del handshake TLS e intercambios de encabezados, lo cual es invaluable para depuración. La opción -k (o --insecure) le dice a cURL que omita la verificación de certificados TLS, útil para entornos de desarrollo con certificados autofirmados pero peligroso en producción. La opción -L (o --location) le dice a cURL que siga redirecciones HTTP (respuestas 3xx), que muchas APIs y sitios web emiten.

Cómo Funciona la Conversión

Convertir un comando cURL a código fuente involucra varios pasos discretos. El convertidor primero tokeniza la cadena de entrada, dividiéndola en espacios en blanco mientras respeta las comillas simples y dobles para que los valores de encabezados y los cuerpos JSON con espacios se mantengan intactos. Luego, recorre la lista de tokens secuencialmente, identificando opciones conocidas y consumiendo sus argumentos. Una opción como -X consume el siguiente token como el método HTTP; -H consume el siguiente token como una cadena de encabezado; -d o --data consume el siguiente token como el cuerpo de la solicitud. Los tokens que no están asociados con ninguna opción y parecen URLs (que comienzan con http:// o https://) se capturan como la URL de destino.

Una vez completado el análisis, el convertidor mantiene una representación estructurada de la solicitud: la URL, el método HTTP, una lista de encabezados (cada uno dividido en nombre y valor en el primer dos puntos), la cadena del cuerpo sin procesar y cualquier credencial de autenticación. Esta representación intermedia es independiente del lenguaje. El paso final es la generación de código, donde una plantilla específica del lenguaje mapea cada componente a los idiomas HTTP del lenguaje de destino. El método se convierte en un argumento de función o una constante, los encabezados se convierten en un diccionario o arreglo asociativo, y el cuerpo se adjunta de la manera que la biblioteca espera. El código generado está formateado con indentación adecuada y listo para ejecutar.

Los casos especiales requieren manejo especial. Los comandos cURL multilínea que usan continuación con barra invertida (\ al final de una línea) se unen antes del análisis. La opción -u se traduce a un mecanismo de autenticación Basic específico del lenguaje en lugar de dejarse como un encabezado sin procesar. Los encabezados duplicados se preservan en orden, porque algunas APIs dependen de múltiples valores para el mismo nombre de encabezado (por ejemplo, múltiples encabezados Set-Cookie). El convertidor también elimina los caracteres de prompt de shell $ o % que a veces aparecen cuando un comando se copia de un tutorial o captura de pantalla de terminal.

Bibliotecas HTTP Específicas por Lenguaje

Cada lenguaje de destino usa una biblioteca diferente con sus propias convenciones para construir solicitudes HTTP. Entender estas diferencias le ayuda a elegir la salida correcta y modificar el código generado cuando sea necesario.

Python — requests

La biblioteca requests es el cliente HTTP más popular en el ecosistema Python. Proporciona una API simple y de alto nivel donde el método HTTP se mapea directamente a un nombre de función: requests.get(), requests.post(), y así sucesivamente. Los encabezados se pasan como un diccionario simple al argumento de palabra clave headers. Los cuerpos JSON pueden pasarse mediante el parámetro json, que establece automáticamente el encabezado Content-Type y serializa el diccionario. El parámetro auth acepta una tupla para autenticación Basic. Los datos de respuesta están disponibles a través de .json(), .text o .content dependiendo del formato deseado.

JavaScript — API fetch

La API fetch está integrada en todos los navegadores modernos y Node.js 18+. Toma una URL como primer argumento y un objeto de opciones como segundo. El objeto de opciones acepta las propiedades method, headers y body. Los encabezados pueden ser un objeto simple o una instancia de Headers. A diferencia de requests en Python, fetch no lanza una excepción en códigos de estado de error HTTP; debe verificar response.ok usted mismo. El cuerpo de la respuesta se consume asincrónicamente a través de métodos como response.json() o response.text(). Como fetch devuelve una Promise, el código generado usa async/await para legibilidad.

Ruby — Net::HTTP

La biblioteca estándar de Ruby incluye Net::HTTP, que es más verbosa que los equivalentes de Python o JavaScript pero no requiere dependencias externas. Una solicitud típica comienza analizando la URL en un objeto URI, luego creando una instancia de Net::HTTP configurada para el host y puerto. Los objetos de solicitud como Net::HTTP::Post o Net::HTTP::Get representan el método. Los encabezados se establecen usando notación de corchetes en el objeto de solicitud. El cuerpo se asigna directamente. Para URLs HTTPS, use_ssl debe establecerse en true. Debido a esta ceremonia, muchos desarrolladores Ruby usan gemas envolventes como Faraday o HTTParty, pero el código generado se mantiene en la biblioteca estándar para máxima portabilidad.

PHP — Extensión cURL

La extensión cURL de PHP envuelve la misma biblioteca libcurl que alimenta la herramienta de línea de comandos curl. El flujo de trabajo gira en torno a un handle creado con curl_init(). Las opciones se establecen mediante llamadas a curl_setopt(): CURLOPT_URL para la URL de destino, CURLOPT_CUSTOMREQUEST para el método HTTP, CURLOPT_HTTPHEADER para un arreglo de cadenas de encabezados y CURLOPT_POSTFIELDS para el cuerpo de la solicitud. Establecer CURLOPT_RETURNTRANSFER en true hace que curl_exec() devuelva la respuesta como una cadena en lugar de imprimirla. Como la extensión PHP refleja de cerca la API en C de libcurl, el código PHP generado se mapea casi uno a uno con las opciones originales de cURL, haciendo esta la conversión más transparente de los cuatro lenguajes.

Preguntas Frecuentes

¿Qué es cURL?

cURL es una herramienta de línea de comandos para hacer solicitudes HTTP. Viene preinstalado en Linux, macOS y Windows 10+, y es la herramienta estándar para probar APIs.

¿Cómo leo un comando cURL?

Comienza con curl seguido de una URL. Use -X para el método, -H para encabezados, -d para datos del cuerpo y -u para autenticación.

¿Qué métodos HTTP soporta cURL?

Todos los métodos estándar: GET, POST, PUT, PATCH, DELETE, HEAD y OPTIONS. Establezca el método con la opción -X.

¿Puedo convertir cURL con autenticación?

Sí. La herramienta maneja autenticación Basic (-u), tokens Bearer (-H Authorization) y otros patrones de autenticación basados en encabezados.

¿Maneja datos de formulario multiparte?

Sí. Los comandos con opciones -F para subidas de archivos y campos de formulario se convierten a la sintaxis multiparte apropiada en cada lenguaje.