Quando usar curl
Use curl para inspecionar respostas HTTP, baixar um recurso ou chamar um API do servidor. Separe o sucesso do transporte do sucesso do aplicativo, defina tempos limite razoáveis e mantenha os tokens de autenticação fora dos exemplos de comandos salvos.
Sintaxe
curl [PARAMETERS] URLColchetes marcam argumentos opcionais; uma reticência significa repetição. Substitua exemplos de nomes de arquivos, nomes de usuários e endereços de servidores por seus próprios valores.
Opções e argumentos comuns
Exemplos de uso
Verifique os cabeçalhos do site
curl -I https://example.comÉ feita uma solicitação somente de cabeçalho; alguns serviços lidam com isso de maneira diferente de uma solicitação de conteúdo normal.
Baixar arquivo com processamento de erros HTTP
curl --fail --location --output ./page.html https://example.comOs redirecionamentos são seguidos e o corpo da resposta substitui o arquivo local nomeado; Os status de erro HTTP causam falha.
Solicitação JSON com limite de tempo
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusUma resposta JSON é solicitada com duração geral limitada; o terminal deve realmente fornecer esse API.
Notas e limitações
- Com HTTPS o certificado é verificado por padrão; não desative a verificação via -k sem um motivo específico.
- Não coloque tokens ou senhas reais no histórico de comandos e não execute scripts baixados sem verificação.
Perguntas comuns e solução de problemas
Por que curl é bem-sucedido quando o servidor retorna uma página de erro?
Sem a opção de falha, receber uma resposta de erro HTTP ainda pode contar como uma transferência bem-sucedida. Inspecione o status do HTTP e o status de saída do comando.
Devo desabilitar a verificação de certificado para corrigir HTTPS?
Não ignore a confiança como uma solução de rotina. Verifique o nome do host, a hora do sistema, a cadeia de certificados do servidor e a configuração da CA confiável.
Mais ajuda
As opções variam de acordo com a versão e distribuição. Verifique a documentação instalada com este comando: man curl.