Como usar o comando curl para testar uma API direto do servidor (SSH & Avançado)
Olá, querido(a) cliente da GeHost! 👋
Se você está aqui, provavelmente quer testar uma API diretamente do seu servidor — sem precisar de ferramentas externas, sem depender de outros computadores. Que bom que você está no lugar certo!
Hoje, vou te ensinar, com calma e carinho, como usar o comando curl no terminal (via SSH) para fazer requisições a uma API diretamente do seu servidor. É como um "teste de saúde" para seu sistema — rápido, poderoso e muito útil para desenvolvedores e administradores.
Seu servidor já está pronto. Só falta você aprender a conversar com ele. Vamos lá?
Pré-requisitos: Acesso via SSH
Antes de tudo, você precisa ter acesso ao seu servidor via SSH. Isso é possível apenas se seu plano de hospedagem permitir acesso SSH (geralmente nos planos Básico, Médio e Plus).
- Verifique no painel do cliente se seu plano inclui SSH.
- Se sim, você pode acessar o servidor usando um cliente SSH como Putty (Windows), Terminal (Mac) ou Windows Terminal com SSH habilitado.
- Se não souber como fazer isso, posso te ajudar com um guia específico. É só pedir no suporte!
Passo a passo: Testando uma API com curl
Vamos imaginar que você quer testar uma API que responde com dados em JSON, como:
URL da API: https://seusite.com.br/api/dados
Método: GET
Pronto? Vamos lá:
- Conecte-se ao servidor via SSH usando seu usuário e senha (ou chave SSH, se configurado).
- Uma vez dentro do terminal, digite o comando abaixo:
curl -X GET "https://seusite.com.br/api/dados"
{"status":"ok","data":[...]}
Se a resposta vier em branco ou com erro, não se preocupe — isso é parte do aprendizado. Vamos ver como interpretar.
Comandos úteis e dicas práticas
Aqui vão alguns comandos que você pode usar com o curl para testar APIs com mais precisão:
- Testar com cabeçalhos (headers):
curl -X GET "https://seusite.com.br/api/dados" -H "Authorization: Bearer seu_token_aqui"Use isso quando a API exigir autenticação.
- Enviar dados via POST:
curl -X POST "https://seusite.com.br/api/enviar" -d '{"nome":"João","email":"joao@exemplo.com"}' -H "Content-Type: application/json"Perfeito para testar formulários ou endpoints que recebem dados.
- Ver apenas o código de resposta:
curl -I "https://seusite.com.br/api/dados"Isso mostra apenas o status HTTP (ex: 200, 404, 500).
- Salvar a resposta em um arquivo:
curl -X GET "https://seusite.com.br/api/dados" -o resposta.jsonUse isso para analisar depois, sem perder o conteúdo.
Dicas do Sensei da GeHost
✨ Importante: O curl é uma ferramenta poderosa, mas precisa ser usada com cuidado. Sempre verifique a URL e os dados que você está enviando.
💡 Dica prática: Se a API estiver em um domínio hospedado com você, pode testar diretamente com o nome do domínio (ex: https://meusite.com.br/api) — o servidor já sabe como lidar com isso.
🛠️ Se algo der errado: Verifique se:
- A API está realmente disponível (pode ser um erro temporário).
- O domínio está configurado corretamente no cPanel (DNS, SSL, etc.).
- Se a API exige HTTPS, certifique-se de que o certificado SSL está instalado (use o certificado SSL no cPanel).
Imagem de apoio: Acessando o terminal via SSH
Para te ajudar a se localizar, aqui está uma imagem do login no cPanel — onde você pode encontrar o acesso ao terminal (se disponível em seu plano):
Se o seu plano inclui SSH, você vai encontrar uma opção como "Terminal" ou "SSH Access" no painel — geralmente na seção "Acesso" ou "Segurança".
Conclusão: Você está no controle!
Com o curl, você não precisa mais depender de ferramentas externas para testar APIs. É como ter um microscópio no seu servidor — você vê tudo que está acontecendo, diretamente no local.
Se tiver dúvidas, quiser um exemplo específico ou precisar de ajuda com algum erro, é só chamar o suporte da GeHost. Estamos aqui para te ajudar, sempre.
Até a próxima, com muita energia positiva e código limpo! 💻✨
GeHost — hospedagem que cuida de você, com carinho e tecnologia de ponta.
Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)
