O que ele faz?

O Conversor de cURL para código transforma um comando curl em código que envia a mesma solicitação HTTP a partir do seu próprio programa. Ele gera três tipos de código:

  • JavaScript (fetch): a API fetch integrada aos navegadores, ao Deno, ao Bun e ao Node.js.
  • Node.js (Axios): a popular biblioteca Axios, com módulos do Node.js para arquivos e configurações de TLS.
  • Python (Requests): a biblioteca Requests.

Uma maneira comum de obter um comando é usar as ferramentas de desenvolvedor do navegador: no painel Rede, clique com o botão direito em uma solicitação e escolha Copiar como cURL. A documentação de APIs também costuma apresentar exemplos como comandos curl.

Como usar

  1. Cole o comando curl. Comandos longos podem ocupar várias linhas, com uma barra invertida no final de cada linha, como os shells esperam.
  2. Escolha a linguagem.
  3. Copie o código ou baixe-o como arquivo (request.mjs para JavaScript, request.py para Python).

O código é atualizado enquanto você digita. Se o comando tiver um erro que impeça o próprio curl de executá-lo, como uma aspa sem fechamento ou uma opção desconhecida, a ferramenta o indicará.

O que é convertido

  • O método, incluindo os métodos que o curl escolhe automaticamente: -d e -F usam POST, -I usa HEAD e -T usa PUT.
  • A URL, incluindo qualquer consulta adicionada por -G ou --url-query.
  • Cabeçalhos de -H, o agente do usuário de -A, o referenciador de -e e os cookies de -b, que são convertidos em um dicionário cookies no Python.
  • A autenticação básica de -u ou da URL, usando o método próprio de cada biblioteca, e tokens Bearer de --oauth2-bearer. No Python, também é incluída a autenticação Digest.
  • Corpos: JSON de --json ou de um Content-Type JSON é convertido em um objeto ou dicionário; dados de formulário de -d são convertidos em URLSearchParams ou em um dicionário; e formulários multipart de -F são convertidos em FormData ou em um dicionário files, incluindo os arquivos enviados.
  • O tempo limite de --max-time (e de --connect-timeout no Python), -k para ignorar verificações de TLS, certificados de CA e de cliente, e um proxy de -x.

Os cabeçalhos que o curl adiciona por conta própria, como o próprio User-Agent, Accept: */* e Content-Length, são omitidos, pois as bibliotecas enviam os seus próprios. As opções que alteram apenas a forma como o curl exibe a resposta, como -s ou -v, também são omitidas.

Quando algo não pode ser convertido

Alguns recursos não têm equivalente em uma biblioteca ou linguagem. Eles são incluídos como comentários no início do código, para que nada seja omitido sem aviso:

  • As opções sem equivalente, como --retry, são listadas como "Não convertido".
  • fetch não pode ignorar verificações de TLS, usar um proxy ou definir um tempo limite de conexão, e os navegadores não permitem que scripts definam o cabeçalho Cookie, embora o Node.js permita.
  • Os arquivos que o curl lê, como -d @data.json ou -F photo=@cat.jpg, são lidos do disco no Node.js e no Python. No JavaScript executado no navegador, eles aparecem como marcadores que você deve substituir, por exemplo, por um arquivo selecionado em um elemento <input type="file">.
  • Quando um comando envia várias solicitações, o código corresponde à primeira.

Exemplos

  • curl https://example.com/ é convertido em requests.get("https://example.com/") no Python.
  • curl -u ada:secret https://api.example.com/me é convertido em auth=("ada", "secret") no Python e em uma opção auth no Axios.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders é convertido em json={"item": "sourdough loaf"} no Python e em JSON.stringify({ item: "sourdough loaf" }) com fetch.

Como funciona

O comando é interpretado da mesma forma que um shell e o curl o interpretariam, respeitando aspas, caracteres de escape e continuações de linha, pelo mesmo analisador usado pelo Validador de comandos cURL do site. Em seguida, o código é gerado a partir da solicitação que o curl enviaria. Tudo acontece no seu navegador, portanto, comandos com tokens ou senhas nunca saem do seu dispositivo.

Recursos

  • JavaScript fetch, Node.js Axios e Python Requests
  • Cabeçalhos, cookies e autenticação Basic e Bearer
  • Corpos JSON, de formulário, multipart e com arquivos
  • Tempos limite, opções de TLS, certificados e proxies
  • Comentários para tudo o que não pode ser convertido
  • Mensagens claras para erros no comando
  • Copiar ou baixar o código
  • Executado no seu navegador