Quando utilizar curl
Utilize curl para inspecionar respostas HTTP, descarregar um recurso ou chamar um API do servidor. Separe o sucesso do transporte do sucesso da aplicação, defina tempos limite razoáveis e mantenha os tokens de autenticação fora dos exemplos de comandos guardados.
Sintaxe
curl [PARAMETERS] URLOs colchetes marcam argumentos opcionais; uma reticência significa repetição. Substitua exemplos de nomes de ficheiros, nomes de utilizadores e endereços de servidores pelos 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 apenas de cabeçalho; alguns serviços lidam com isto de forma diferente de um pedido de conteúdo normal.
Descarregue o ficheiro com processamento de erros HTTP
curl --fail --location --output ./page.html https://example.comOs redireccionamentos são seguidos e o corpo da resposta substitui o ficheiro local nomeado; Os estados de erro HTTP causam falha.
Pedido JSON com limite de tempo
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusÉ solicitada uma resposta JSON com duração geral limitada; o terminal deve realmente fornecer esse API.
Notas e limitações
- Com o HTTPS o certificado é verificado por defeito; não desative a verificação através do -k sem um motivo específico.
- Não coloque tokens ou palavras-passe reais no histórico de comandos e não execute scripts descarregados sem verificação.
Perguntas comuns e resolução de problemas
Porque é que o curl é bem-sucedido quando o servidor devolve uma página de erro?
Sem a opção de falha, receber uma resposta de erro HTTP pode ainda contar como uma transferência bem-sucedida. Inspecione o estado do HTTP e o estado de saída do comando.
Devo desativar a verificação de certificados para corrigir o 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 AC fidedigna.
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.