Linux Sabe Mais

Comandos, exemplos e soluções para o dia a dia.

BIBLIOTECA LINUX
741 tutoriais · 1406 exemplos
Documentação em português
Aprender Linux · passo a passo

O comando curl no Linux

Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.

O que faz e quando utilizar

Cabeçalhos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

Como escrever o comando

curl [opções] URL

Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.

O nome curl identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.

Exemplos explicados

Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.

1. Cabeçalhos

Cabeçalhos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -I https://example.com
2. Seguir redirecionamentos

Seguir redirecionamentos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -IL https://example.com
3. Código HTTP

Código HTTP. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -sS -o /dev/null -w "%{http_code}\n" https://example.com
4. Tempo de resposta

Tempo de resposta. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -sS -o /dev/null -w "%{time_total}\n" https://example.com
5. Testar vhost local

Testar vhost local. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl --resolve teste.exemplo.test:80:192.0.2.15 -I http://teste.exemplo.test/
6. Diagnóstico detalhado

Diagnóstico detalhado. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -vI https://example.com
7. Guardar ficheiro

Guardar ficheiro. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -fL -o ficheiro.zip https://example.com/ficheiro.zip
8. Timeout

Timeout. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl --connect-timeout 5 --max-time 15 -I https://example.com
9. Mostrar certificados

Mostrar certificados. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -vI https://example.com 2>&1 | grep -i certificate
10. POST JSON (exemplo)

POST JSON (exemplo). Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.

curl -X POST -H "Content-Type: application/json" -d '{"teste":true}' https://example.com/api
11. Consultar cabeçalhos de um serviço local

Pede apenas os cabeçalhos HTTP a um serviço no próprio computador.

curl -I --max-time 10 http://127.0.0.1/

Como interpretar

-I utiliza o método HEAD e --max-time limita a duração total a dez segundos. O exemplo só contacta a interface local.

O código HTTP descreve a resposta recebida; um servidor pode tratar HEAD de forma diferente de GET, pelo que esta consulta não testa toda a página.

Erros frequentes e como os evitar

  • Nomes de contas, pacotes, dispositivos e caminhos são ilustrativos: têm de corresponder ao sistema onde vais trabalhar.
  • Não assumes que /dev/hda ou /dev/sda identificam o mesmo disco em duas máquinas. Confirma o dispositivo e o estado de montagem.

Uma forma de praticar

Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.

Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.