Conversor de cURL

Um conversor cURL rápido e privado

Desenvolvedores frequentemente encontram comandos cURL em documentações de API, tutoriais ou ao depurar requisições de rede no navegador. Traduzir essas strings de linha de comando para o código da aplicação manualmente é tedioso e sujeito a erros, especialmente ao lidar com cabeçalhos complexos e payloads JSON aninhados.

Este conversor cURL automatiza o processo, permitindo converter comandos curl em snippets de código prontos para uso instantaneamente. Como a conversão ocorre totalmente no seu navegador, seus dados sensíveis — como bearer tokens, chaves de API e payloads privados — nunca saem da sua máquina. Você pode colar com segurança comandos contendo credenciais de produção sem se preocupar com vazamentos de dados ou logs do servidor.

Formatos de saída suportados

Atualmente, a ferramenta permite converter requisições de linha de comando para dois dos ambientes de programação mais utilizados:

JavaScript (fetch)
Desenvolvedores JavaScript frequentemente precisam converter exemplos de API para código frontend ou Node.js. Ao selecionar a opção JavaScript, a ferramenta mapeia o método, os cabeçalhos e os dados do cURL diretamente para uma chamada padrão do fetch(). Isso torna a conversão de curl para javascript um processo de apenas um clique. Ela estrutura automaticamente os cabeçalhos em um objeto JavaScript e garante que o payload JSON seja formatado corretamente como um corpo em formato de string, pronto para ser inserido em uma função async/await.

Python (requests)
Desenvolvedores Python dependem muito da biblioteca requests para interações HTTP. A ferramenta analisa a sintaxe do cURL e gera um código Python limpo, selecionando automaticamente o método correto (como requests.get ou requests.post) e estruturando os cabeçalhos e dados como dicionários Python. Converter curl para python requests garante que você não perca nenhuma configuração sutil de cabeçalho nem formate incorretamente seus tokens de autenticação.

Casos de uso comuns

Integração de APIs de terceiros
A maioria das documentações de APIs modernas (como Stripe, Twilio ou GitHub) fornece exemplos de código principalmente em cURL. Embora seja ótimo para testes rápidos no terminal, você eventualmente precisará dessa requisição na sua aplicação. Colar o exemplo da documentação nesta ferramenta oferece um ponto de partida perfeito para o seu código.

Replicação de requisições do navegador
Ao depurar uma aplicação web, é comum abrir as ferramentas de desenvolvedor do navegador, ir na aba Network (Rede), clicar com o botão direito em uma requisição com erro e selecionar "Copy as cURL". Você pode colar essa string exata no conversor para gerar um script. Isso é extremamente útil para criar testes automatizados, fazer web scraping ou isolar um bug fora do ambiente complexo do navegador.

Prototipagem e testes
Muitos desenvolvedores preferem montar e testar suas requisições HTTP primeiro no terminal. Assim que o comando curl retornar a resposta 200 OK esperada, você pode trazê-lo para cá para gerar instantaneamente o código fetch ou requests equivalente, garantindo que seu app envie exatamente os mesmos bytes do seu teste bem-sucedido no terminal.

Como a conversão funciona

Quando você cola sua entrada, a ferramenta analisa a string para extrair os componentes principais de uma requisição HTTP:

• A URL: O endpoint de destino da requisição.
• O Método: Extraído da flag -X ou --request (ex: GET, POST, PUT, DELETE). Se omitido, o padrão é GET, ou POST se houver dados.
• Cabeçalhos: Extraídos de cada flag -H ou --header. Eles são compilados em um dicionário ou objeto.
• Dados/Payload: Extraídos das flags -d, --data ou --data-raw.

Embora a ferramenta lide com a grande maioria das requisições de API padrão, o cURL é um utilitário enorme com centenas de flags complexas (como --compressed, --resolve ou caminhos específicos de certificados SSL). Se o parser encontrar flags que não se mapeiam perfeitamente para as configurações padrão do fetch ou requests, ele focará na requisição HTTP principal e ignorará essas flags específicas.

Quaisquer argumentos ignorados são listados de forma conveniente abaixo do código gerado. Isso garante que você saiba exatamente o que ficou de fora, permitindo configurar manualmente opções avançadas de proxy ou SSL no código da sua aplicação, caso sejam estritamente necessárias.

Ferramentas úteis relacionadas

Trabalhar com APIs geralmente envolve mais do que apenas escrever a requisição. Depois de fazer sua requisição com sucesso usando o código gerado, você pode precisar formatar os dados resultantes usando um Formatador JSON para torná-los legíveis. Se a sua requisição falhar e você precisar entender o código de resposta recebido, consulte nossa referência de Códigos de Status HTTP. Por fim, se você precisar desmembrar ou modificar a própria URL do endpoint antes da conversão, o Analisador de URL pode ajudar a extrair e editar parâmetros de consulta específicos.