Como usar o comando curl para testar uma API direto do servidor

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á:

1. Conecte-se ao servidor via SSH usando seu usuário e senha (ou chave SSH, se configurado).
2. Uma vez dentro do terminal, digite o comando abaixo:

curl -X GET "https://seusite.com.br/api/dados"

3. Pressione Enter. O servidor vai fazer a requisição e mostrar a resposta na tela.
4. Se a API estiver funcionando, você verá algo como:

{"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.json

  Use 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)