Rede e acesso remoto

Comando curl

Envie pedidos HTTP e descarregue dados

Linux · Exemplos de Bash · comandos executados no servidor seleccionado

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] URL

Os 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

-I
Solicite apenas os cabeçalhos HTTP, utilizando o método HEAD.
-f
Retorna um erro para os códigos de estado HTTP 400 e superiores.
-L
Siga os redirecionamentos; -o especifica o ficheiro de resultados.

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.com

Os 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.