Convertidor de cURL

¿Qué es un convertidor de cURL?

Un convertidor de cURL transforma un comando curl -el formato que emiten todas las documentaciones de APIs, exportaciones de Postman y asistentes de IA- en código listo para pegar en tu lenguaje de programación real. Las cabeceras, query strings, cuerpos JSON, subidas multipart, autenticación básica y cookies se trasladan automáticamente, así no tienes que traducir la petición a mano.

curl es la forma universal de describir una petición HTTP, pero rara vez *ejecutas* curl en producción. Ejecutas JavaScript fetch, Python requests, el net/http de Go o lo que use tu stack. Esta herramienta cubre ese hueco: pegas el curl, haces clic en una pestaña y copias el código.

Todo se ejecuta localmente en tu navegador. Tu comando curl, las cabeceras y los tokens nunca salen de tu máquina - útil cuando pegas comandos con bearer tokens o cookies de sesión reales.

Lo que aprenderás al convertir

• Las flags de curl se corresponden con conceptos concretos en cualquier cliente HTTP: -H es una cabecera de petición, -d es un cuerpo, -X es el método, -u es autenticación básica, -F es un campo de formulario multipart.
• Si curl detecta un cuerpo (-d, --data, -F) y no hay -X, usa POST por defecto - el mismo valor por defecto de la mayoría de clientes, así que un -X no especificado también se convierte en POST en la salida.
• Los cuerpos JSON son distintos de los cuerpos de formulario. Content-Type: application/json significa que el cuerpo se envía literal; application/x-www-form-urlencoded significa que los pares clave/valor se unen con &.
• -G promueve el cuerpo a query string en peticiones GET. La salida lo refleja - verás params / query rellenos y ningún cuerpo enviado.

Cómo convertir curl a código paso a paso

1. 1

   Pega tu comando curl

   Coloca el comando completo -incluyendo las continuaciones de línea \ copiadas de la documentación- en el cuadro de entrada. El parser normaliza automáticamente las comillas tipográficas y los marcadores de prompt de PowerShell.

2. 2

   Elige el lenguaje de destino

   Las pestañas cubren JavaScript fetch, TypeScript, Node axios, Python requests, Python httpx, Go, PHP, Ruby, Java HttpClient, C# HttpClient, HTTPie y PowerShell. Cambiar de pestaña es gratis - el parseo se hace una sola vez.

3. 3

   Inspecciona la petición parseada

   Abre el panel *Petición parseada* para confirmar que el método, la URL, las cabeceras, el tipo de cuerpo y opciones como insecure o follow redirects se han interpretado como esperabas.

4. 4

   Copia y ajusta la autenticación

   Copia el código generado en tu proyecto. Si el curl incluía un bearer token o una cookie, sustituye el valor literal por una variable de entorno antes de hacer commit.

Referencia rápida de flags de cURL

Las flags que entiende este convertidor y a qué se corresponden en el código generado.

Ejemplos de conversión de cURL

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

Errores habituales al convertir curl

• Pegar curl con comillas tipográficas (', ', ", ") sacadas de un blog - parecen comillas pero rompen el parseo de la shell. El convertidor las normaliza, pero copia el comando original siempre que puedas.
• Dejar -k (--insecure) en producción. Desactiva la verificación del certificado TLS - bien para desarrollo local, peligroso en tráfico real.
• Olvidar que --data-raw y --data se comportan de forma distinta - --data codifica la entrada en URL. Usa --data-raw para cuerpos JSON que incluyan @ o &.
• Pegar un comando curl.exe de Windows sin traducir las continuaciones de línea ^ a \. El convertidor maneja esto, pero el parser es estricto con las comillas - comprueba bien los límites de las cadenas.
• Copiar bearer tokens o cookies al control de versiones tras la conversión. Cámbialos por variables de entorno (process.env.API_TOKEN, os.environ['API_TOKEN']) antes de hacer commit.

Preguntas frecuentes sobre el convertidor de cURL