¿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

  1. 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.
  2. Elige el lenguaje.
  3. Copia el código o descárgalo como archivo (request.mjs para JavaScript, request.py para 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: -d y -F usan POST, -I usa HEAD y -T usa PUT.
  • La URL, con cualquier parámetro de consulta que añadan -G o --url-query.
  • Los encabezados de -H, el agente de usuario de -A, el referente de -e y las cookies de -b, que se convierten en un diccionario cookies en Python.
  • La autenticación básica de -u o 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 --json o de un tipo de contenido JSON se convierte en un objeto o diccionario; los datos de formulario de -d se convierten en URLSearchParams o en un diccionario; y los formularios multiparte de -F se convierten en FormData o en un diccionario files, incluidos los archivos adjuntos.
  • El tiempo de espera de --max-time (y --connect-timeout en Python), -k para 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.json o -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 en requests.get("https://example.com/") en Python.
  • curl -u ada:secret https://api.example.com/me se convierte en auth=("ada", "secret") en Python y en una opción auth en Axios.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders se convierte en json={"item": "sourdough loaf"} en Python y en JSON.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