cURL Builder
Understand cURL Builder
Monta um comando curl executável — e a chamada fetch() equivalente em JavaScript — a partir de uma URL, método, cabeçalhos, corpo e autenticação.
How it works
O comando é montado a partir de flags, e não de texto livre: `-X` define o método, cada cabeçalho vira um `-H` próprio, `-d` fornece o corpo, `-u` fornece as credenciais Basic e `-L` segue redirecionamentos. Os valores são envolvidos em aspas simples e qualquer aspa simples dentro do corpo é escapada como `'\''`, que é a única forma segura de embutir uma em uma string de shell POSIX. Se você fornece um corpo sem Content-Type, um é acrescentado para você — application/json quando o corpo começa com `{` ou `[`, text/plain caso contrário —, porque, do contrário, o curl assume application/x-www-form-urlencoded e o servidor lê seu JSON errado. Nada é enviado; a ferramenta só produz texto.
When to use it
- Transformar uma requisição que você montou em um formulário em um comando que dá para colar em um terminal, em um job de CI ou em um relatório de bug
- Produzir uma linha reproduzível para um chamado de suporte, em que um comando curl é a forma menos ambígua de descrever uma requisição
- Obter um esqueleto de fetch() com os cabeçalhos e o corpo já preenchidos, para colar no código da aplicação
- Documentar um endpoint de API em um README com um exemplo copiar-e-colar que de fato roda
Watch out for
- A saída com aspas simples é sintaxe de shell POSIX. O cmd.exe do Windows não trata aspas simples como delimitador — use o Git Bash, o WSL ou converta as aspas antes de rodar ali.
- `-k` desativa a verificação de certificado TLS para a requisição inteira. É uma flag de depuração para um certificado autoassinado em uma máquina sua, nunca algo para deixar em um script.
- A autenticação Basic é Base64, não criptografia. O trecho em fetch codifica `usuario:senha` com btoa, e qualquer um que leia o comando, o histórico do shell ou o log de CI tem a senha.
- Um comando gerado contém o seu token real. Oculte-o antes de colar em uma issue, em um chat ou em um commit.
Frequently Asked Questions
Como enviar uma requisição POST com corpo JSON no curl?
Use: curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/endpoint. O construtor gera isso automaticamente quando você escolhe o método POST, acrescenta o cabeçalho Content-Type e cola o seu JSON no corpo.
Como adicionar cabeçalhos de autenticação no curl?
Para token Bearer: -H "Authorization: Bearer SEU_TOKEN". Para autenticação Basic: -u usuario:senha (o curl codifica isso como um cabeçalho Authorization em Base64 automaticamente) ou -H "Authorization: Basic BASE64_CODIFICADO". O construtor tem uma seção de autenticação para os dois casos.
Como converter curl para código em Python, JavaScript ou Go?
Esta ferramenta gera a chamada equivalente em fetch() do JavaScript. Para outras linguagens, use a saída do curl — é o formato HTTP mais universal. Ferramentas como o curlconverter.com convertem comandos curl para muitas linguagens, se você precisar.
How to Use cURL Builder
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.