Conversor de cURL

O que é um conversor de cURL?

Um conversor de cURL transforma um comando curl - o formato que aparece em toda documentação de API, exportação do Postman e resposta de assistente de IA - em código pronto para colar na linguagem que você usa de verdade. Cabeçalhos, query strings, corpos JSON, uploads multipart, autenticação básica e cookies são todos preservados, então você não precisa traduzir a requisição na mão.

curl é a forma universal de descrever uma requisição HTTP, mas você raramente *executa* curl em produção. Você executa JavaScript fetch, Python requests, net/http do Go ou o que sua stack usar. Esta ferramenta cobre essa lacuna: cole o curl, clique numa aba, copie o código.

Tudo roda localmente no navegador. Seu comando curl, cabeçalhos e tokens nunca saem da sua máquina - útil quando você está colando comandos com bearer tokens reais ou cookies de sessão.

O que você vai aprender enquanto converte

• As flags do curl correspondem a conceitos específicos em todo cliente HTTP: -H é um cabeçalho de requisição, -d é o corpo, -X é o método, -u é autenticação básica e -F é um campo de formulário multipart.
• Se o curl encontra um corpo (-d, --data, -F) e não tem -X, ele assume POST por padrão - o mesmo padrão da maioria dos clientes, então um -X omitido vira POST na saída.
• Corpos JSON são diferentes de corpos de formulário. Content-Type: application/json significa que o corpo é enviado literalmente; application/x-www-form-urlencoded significa que pares chave/valor são unidos com &.
• -G promove o corpo para a query string em requisições GET. A saída reflete isso - você vai ver params / query preenchidos e nenhum corpo sendo enviado.

Como converter curl em código passo a passo

1. 1

   Cole seu comando curl

   Solte o comando completo - incluindo as continuações de linha \ que vêm da documentação copiada - na caixa de entrada. O parser normaliza aspas inteligentes e marcadores de prompt do PowerShell automaticamente.

2. 2

   Escolha a linguagem alvo

   As abas cobrem JavaScript fetch, TypeScript, Node axios, Python requests, Python httpx, Go, PHP, Ruby, Java HttpClient, C# HttpClient, HTTPie e PowerShell. Trocar de aba é grátis - o parse roda só uma vez.

3. 3

   Inspecione a requisição parseada

   Abra o painel *Requisição parseada* para confirmar que o método, a URL, os cabeçalhos, o tipo de corpo e opções como insecure ou follow redirects foram interpretados como você esperava.

4. 4

   Copie e ajuste a autenticação

   Copie o código gerado para o seu projeto. Se o curl tinha um bearer token ou cookie, troque o valor literal por uma variável de ambiente antes de fazer commit.

Referência rápida das flags do cURL

As flags que este conversor entende e o que elas viram no código gerado.

Exemplos de conversão de cURL

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

Erros comuns ao converter curl

• Colar curl com aspas inteligentes (', ', ", ") de algum blog - elas parecem aspas, mas quebram o parsing do shell. O conversor normaliza, mas copie o comando original se puder.
• Deixar -k (--insecure) em produção. Isso desativa a verificação do certificado TLS - tranquilo em dev local, perigoso em tráfego real.
• Esquecer que --data-raw e --data se comportam diferente - --data faz URL-encoding na entrada. Use --data-raw para corpos JSON que contêm @ ou &.
• Colar um comando curl.exe do Windows sem traduzir as continuações ^ para \. O conversor lida com isso, mas o parser é rigoroso com aspas - confira os limites das strings.
• Copiar bearer tokens ou cookies para o controle de versão depois de converter. Troque por variáveis de ambiente (process.env.API_TOKEN, os.environ['API_TOKEN']) antes de commitar.

Perguntas frequentes sobre o Conversor de cURL