Como usar o comando cURL?

cURL é uma ferramenta que permite a comunicação entre um dispositivo e um servidor direto do terminal

As plataformas de interface de programação de aplicação (API) podem ser úteis para automatizar e criar chamadas de solicitações mais sofisticadas de forma interativa por meio de uma interface de usuário (UI).

O comando cURL faz a mesma coisa, mas direto do terminal. A ferramenta está disponível em Linux e é nativa em MacOS e Windows.

O cURL é gratuito e permite a troca de dados via terminal de um servidor com um dispositivo. A solução é uma das melhores ferramentas para depurar solicitações de rede e testar APIs sem interação do usuário.

Assim como pode ser usada também como aplicativo de console autônomo ou compilado em outros programas, como uma biblioteca dinâmica (libcurl).

O cURL tem suporte integrado para SSL, autenticação de usuário, validação de certificado e cookies HTTP.

Além disso, pode também ser usado para fazer download ou upload de arquivos, enviar formulários da web, enviar solicitações para endpoints de API e simular ações do usuário sem usar um navegador da web.

Por que usar cURL?

O cURL pode ser útil para criar um script que emita programaticamente várias solicitações de API e grave as respostas em um arquivo ou para desenvolvedores que preferem uma boa ferramenta de linha de comando a um aplicativo de interface gráfica do usuário (GUI).

Independentemente de você realmente usar cURL, é importante pelo menos estar familiarizado com ele, porque a documentação da API geralmente contém exemplos que mostram como emitir solicitações de API usando cURL.

Em APIs mais recentes, que ainda não oferecem kits de desenvolvimento de software (SDKs) correspondentes em várias linguagens de programação, geralmente são encontrados apenas exemplos de cURL nos documentos.

Nesse sentido, é necessário pelo menos entender a sintaxe cURL, para ler e compreender esses exemplos.

Primeiros passos no cURL

No Windows ou MacOS, a máquina provavelmente tem o cURL instalado por padrão. Ainda assim, para determinar se o cURL está instalado, abra um prompt de comando e digite o seguinte:

$ curl –help

Se o comando não for reconhecido, então o cURL ainda não está instalado.

Caso o comando resulte na exibição de algum conteúdo de ajuda limitado, então isso significa que o cURL já está instalado.

Download do cURL

Se o cURL não estiver instalado na máquina, e caso você utilize Windows, é necessário baixar o executável (curl.exe).

O cURL Download Wizard no site oficial ajuda a determinar qual é a versão certa a ser baixada.

Primeiro comando

O cURL é uma ferramenta que roda localmente, ou seja, assim que estiver presente na máquina, a primeira solicitação de API pode ser emitida.

Para fazer isso, abra um prompt de comando e digite conforme abaixo:

$ curl –- version

Então a ferramenta informará qual é a versão do aplicativo instalado.

Principais comandos cURL

O cURL é uma ferramenta de linha de comando para fazer todos os tipos de manipulação e transferência de URL. A ferramenta faz as requisições, pega os dados, envia-os e recupera as informações. 

A sintaxe de um comando cURL é:

$ cURL [opções] [URL]

Conheça os principais comandos a seguir.

• -A: especifica o USER_AGENT.
• -b: salva um cookie em arquivo.
• -c: envia um cookie para o servidor a partir de um arquivo.
• -C: continua carregando o arquivo da quebra ou do deslocamento especificado.
• -d: envia dados usando o método POST.
• -E: usa um certificado SSL externo.
• -F: envia dados como um formulário.
• -G: se essa opção estiver habilitada, todos os dados especificados na opção -d são transferidos usando o método GET.
• -H: envia cabeçalhos para o servidor.
• -I: recebe apenas o cabeçalho HTTP e ignora todo o conteúdo da página.
• -L: aceita e processa redirecionamentos.
• -o: saída do conteúdo da página para um arquivo.
• -O: salva o conteúdo em um arquivo com o nome da página ou do arquivo no servidor.
• -p: usa proxy.
• -v: saída detalhada máxima.

1. Obter uma resposta de um servidor

Tudo no servidor é uma resposta ao pedido; portanto, obter uma página HTML é o mesmo que baixar um arquivo.

Para obter uma resposta HTML de: https://ajuda.locaweb.com.br/wiki/curl

$ curl https://ajuda.locaweb.com.br/wiki/curl/

Para obter a lista de postagens como resposta de um servidor (https://https://blog.locaweb.com.br/):

$ curl https://blog.locaweb.com.br/

Sabendo como obter uma resposta de um servidor, qualquer arquivo pode ser baixado, como o Brasão Nacional, por exemplo:

$ curl https://www.gov.br/planalto/pt-br/conheca-a-presidencia/acervo/simbolos-nacionais/brasao-da-republica/brasaooficialcolorido.png –output brasao.png

O comando acima despejará os dados da imagem binária, que não pode ser visualizada no terminal. Portanto para isso é preciso salvá-los e usar um visualizador de fotos

para vê-los.

2. Salvar o arquivo com um nome de arquivo padrão

Cada arquivo que é servido na internet tem um nome. Para usar o mesmo nome de arquivo do conteúdo baixado, use o sinalizador -O.

$ curl -O http://www.google.com/robots.txt

3. Salvar o arquivo com um nome personalizado

Para salvar o nome do arquivo com o próprio nome personalizado, use -o como sinalizador seguido (estritamente) por um nome personalizado.

$ curl -O http://www.google.com/robots.txt googleRobots.txt

4. Baixar vários arquivos

Para baixar vários arquivos, separe-os com um espaço em branco, por exemplo:

$ curl url1 url2 url3

Se quiser usar o sinalizador -O para todas as URLs, aplique:

$ curl url1 url2 url3 -O -O -O

Essa mesma solução deve ser usada para qualquer sinalizador.

Isso ocorre porque a primeira ocorrência de determinado sinalizador é para o primeiro URL, o segundo sinalizador é para o segundo URL e assim por diante.

5. Baixar uma variedade de arquivos

O cURL tem a capacidade embutida de baixar uma variedade de arquivos do servidor. Conforme está ilustrado a partir do exemplo a seguir.

$ curl http://www.google.com/logo/logo[1-9].png

Dessa forma o comando acima baixa arquivos de logo1.png, logo2.png, logo3.png e até logo9.png.

6. Baixar um arquivo apenas se for o mais recente

Para baixar um arquivo somente se o horário de modificação do arquivo for mais recente do que o horário especificado, use conforme o exemplo:

$ curl url -z “DD MMM AA MM:HH:SS”