Conversor de cURL para Código
Converta um comando curl em código JavaScript fetch, Axios ou Python Requests, mantendo o mesmo método, cabeçalhos, cookies, autenticação e corpo. Funciona no seu navegador.
Entrada
Saída
Leia-me
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
- Cole o comando curl. Comandos longos podem ocupar várias linhas, com uma barra invertida no final de cada linha, como os shells esperam.
- Escolha a linguagem.
- Copie o código ou baixe-o como arquivo (
request.mjspara JavaScript,request.pypara 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:
-de-Fusam POST,-Iusa HEAD e-Tusa PUT. - A URL, incluindo qualquer consulta adicionada por
-Gou--url-query. - Cabeçalhos de
-H, o agente do usuário de-A, o referenciador de-ee os cookies de-b, que são convertidos em um dicionáriocookiesno Python. - A autenticação básica de
-uou 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
--jsonou de um Content-Type JSON é convertido em um objeto ou dicionário; dados de formulário de-dsão convertidos emURLSearchParamsou em um dicionário; e formulários multipart de-Fsão convertidos emFormDataou em um dicionáriofiles, incluindo os arquivos enviados. - O tempo limite de
--max-time(e de--connect-timeoutno Python),-kpara 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.jsonou-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 emrequests.get("https://example.com/")no Python.curl -u ada:secret https://api.example.com/meé convertido emauth=("ada", "secret")no Python e em uma opçãoauthno Axios.curl --json '{"item": "sourdough loaf"}' https://api.example.com/ordersé convertido emjson={"item": "sourdough loaf"}no Python e emJSON.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