Convertidor de cURL a código
Convierte un comando curl en código JavaScript fetch, Axios o Python Requests, conservando el mismo método, encabezados, cookies, autenticación y cuerpo. Se ejecuta en tu navegador.
Entrada
Salida
Leerme
¿Qué hace?
El conversor de cURL a código transforma un comando curl en código que envía la misma solicitud HTTP desde tu propio programa. Genera tres tipos de código:
- JavaScript (fetch): la API fetch integrada en los navegadores, Deno, Bun y Node.js.
- Node.js (Axios): la popular biblioteca Axios, con módulos de Node.js para archivos y configuración de TLS.
- Python (Requests): la biblioteca Requests.
Una forma habitual de obtener un comando es usar las herramientas para desarrolladores del navegador: en el panel Red, haz clic con el botón derecho en una solicitud y selecciona «Copiar como cURL». La documentación de las API también suele incluir ejemplos en forma de comandos curl.
Cómo usarlo
- Pega el comando curl. Los comandos largos pueden ocupar varias líneas, con una barra invertida al final de cada línea, como esperan los shells.
- Elige el lenguaje.
- Copia el código o descárgalo como archivo (
request.mjspara JavaScript,request.pypara Python).
El código se actualiza mientras escribes. Si el comando tiene un error que impediría que curl se ejecutara, como una comilla sin cerrar o una opción desconocida, la herramienta te lo indica.
Qué se convierte
- El método, incluidos los que curl selecciona automáticamente:
-dy-Fusan POST,-Iusa HEAD y-Tusa PUT. - La URL, con cualquier parámetro de consulta que añadan
-Go--url-query. - Los encabezados de
-H, el agente de usuario de-A, el referente de-ey las cookies de-b, que se convierten en un diccionariocookiesen Python. - La autenticación básica de
-uo de la URL, mediante el método propio de cada biblioteca para enviarla, y los tokens Bearer de--oauth2-bearer. En Python también se incluye la autenticación Digest. - Los cuerpos: el contenido JSON de
--jsono de un tipo de contenido JSON se convierte en un objeto o diccionario; los datos de formulario de-dse convierten enURLSearchParamso en un diccionario; y los formularios multiparte de-Fse convierten enFormDatao en un diccionariofiles, incluidos los archivos adjuntos. - El tiempo de espera de
--max-time(y--connect-timeouten Python),-kpara omitir las comprobaciones de TLS, los certificados de CA y de cliente, y un proxy de-x.
Se omiten los encabezados que curl añade por su cuenta, como su propio User-Agent, Accept: */* y Content-Length, ya que las bibliotecas envían los suyos. También se omiten las opciones que solo cambian la forma en que curl muestra la respuesta, como -s o -v.
Cuando algo no se puede convertir
Algunos elementos no tienen equivalente en una biblioteca o un lenguaje. Se incluyen como comentarios al principio del código para que no se omita nada sin avisar:
- Las opciones sin equivalente, como
--retry, se enumeran como «No convertido». - fetch no puede omitir las comprobaciones de TLS, usar un proxy ni establecer un tiempo de espera de conexión; además, los navegadores no permiten que los scripts establezcan el encabezado Cookie, aunque Node.js sí lo permite.
- Los archivos que curl lee, como
-d @data.jsono-F photo=@cat.jpg, se leen del disco en Node.js y Python. En JavaScript para navegador aparecen como marcadores de posición que debes reemplazar, por ejemplo, por un archivo seleccionado mediante un elemento<input type="file">. - Si un comando envía varias solicitudes, el código corresponde a la primera.
Ejemplos
curl https://example.com/se convierte enrequests.get("https://example.com/")en Python.curl -u ada:secret https://api.example.com/mese convierte enauth=("ada", "secret")en Python y en una opciónauthen Axios.curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersse convierte enjson={"item": "sourdough loaf"}en Python y enJSON.stringify({ item: "sourdough loaf" })con fetch.
Cómo funciona
El comando se interpreta tal como lo harían un shell y curl, con comillas, secuencias de escape y continuaciones de línea, mediante el mismo analizador que usa el Validador de comandos cURL del sitio. Después, se genera código para la solicitud que enviaría curl. Todo ocurre en tu navegador, así que los comandos que contienen tokens o contraseñas nunca salen de tu dispositivo.
Características
- JavaScript fetch, Node.js Axios y Python Requests
- Encabezados, cookies y autenticación básica y Bearer
- Cuerpos JSON, de formulario, multiparte y de archivo
- Tiempos de espera, opciones de TLS, certificados y proxies
- Comentarios para todo lo que no se pueda convertir
- Mensajes claros cuando hay errores en el comando
- Copia o descarga el código
- Se ejecuta en tu navegador