O que é cURL e para que serve?
O cURL (Client for URL) é a ferramenta "canivete suíço" dos desenvolvedores. Criada em 1997, ela permite transferir dados para servidores usando diversos protocolos (HTTP, FTP, SMTP, etc.). Hoje, é o padrão mundial para testar APIs RESTful via linha de comando.
Testar Endpoints
Verifique se sua API está online e respondendo o JSON correto.
Debugar Auth
Teste headers de autenticação (Bearer Token, Basic Auth) isoladamente.
Documentação
Gere exemplos de requisição prontos para colar na doc da sua API.
Guia Definitivo dos Métodos HTTP
Saber qual verbo HTTP usar é a base do REST. Aqui está um resumo visual para você nunca mais esquecer:
| Método | Cor Semântica | O que ele faz? | Exemplo Real |
|---|---|---|---|
| GET | LEITURA | Busca dados do servidor sem alterar nada. | /users/123 |
| POST | CRIAÇÃO | Envia dados novos para criar um recurso. | /users (com JSON) |
| PUT | EDIÇÃO | Substitui um recurso inteiro por um novo. | /users/123 |
| DELETE | REMOÇÃO | Apaga um recurso permanentemente. | /users/123 |
Headers e Autenticação
A parte mais chata de escrever comandos cURL na mão é acertar a sintaxe dos Headers. Um erro comum é esquecer as aspas ou a flag -H.
Autenticação Bearer (Token JWT)
A maioria das APIs modernas usa JWT. Para enviar um token, você precisa do header Authorization.
curl -X GET "https://api.exemplo.com/dados" -H "Authorization: Bearer SEU_TOKEN_AQUI" -H "Content-Type: application/json"
Enviando JSON (POST)
No terminal, aspas duplas dentro do JSON precisam ser "escapadas" (precedidas por \) se você usar aspas duplas fora. Nossa ferramenta faz isso automaticamente para você.
curl -X POST "https://api.exemplo.com/login" -H "Content-Type: application/json" -d "{"email": "usuario@email.com", "senha": "123456"}"Perguntas Frequentes (FAQ)
cURL vs Postman/Insomnia: Qual é melhor?
Postman é ótimo para desenvolvimento visual e coleções de testes.cURL é imbatível para scripts, automação, servidores Linux e compartilhamento rápido de requisições em chats/documentação (já que é texto puro).
O comando gerado funciona no Windows?
Sim! O Windows 10 e 11 já vêm com o cURL instalado no PowerShell e CMD. No entanto, o PowerShell tem algumas peculiaridades com aspas. Nossa ferramenta gera o padrão Bash (Linux/Mac/WSL), que é o mais universal. Se usar PowerShell, talvez precise ajustar as aspas do JSON.
O que significa o erro "Could not resolve host"?
Geralmente significa que a URL está errada ou que você está sem internet. Verifique se digitou https:// no começo.
Precisa validar dados?
Depois de testar sua API, use nosso Formatador JSON para visualizar a resposta ou o Gerador de UUID para criar IDs de teste.