Rede e acesso remoto

Comando curl

Envie solicitações HTTP e baixe dados

Linux · Exemplos de Bash · comandos executados no servidor selecionado

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

Colchetes 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

-I
Solicite apenas cabeçalhos HTTP, usando o método HEAD.
-f
Retorna um erro para códigos de status HTTP 400 e superiores.
-L
Siga redirecionamentos; -o especifica o arquivo de resultado.

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

Os 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/status

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