Usando o Curl para fazer requisições na API

Carolina Estrela
reprogramabr
Published in
3 min readJul 20, 2019

Uma ferramenta a mais para te ajudar no dia a dia do desenvolvimento.

Se você utiliza Linux e gostaria de uma alternativa para fazer requisições para uma API, você tem a opção de utilizar o comando Curl. Para quem não conhece, o Curl é um comando disponível na maioria dos sistemas baseado em Unix, ele suporta o protocolo HTTP e HTTPs, por isso você pode utilizá-lo para fazer requisições em uma API.

Para verificar se sua máquina possui o Curl instalado, abra o terminal (ctrl+alt+t) ou algum outro terminal/promp/shell (no meu caso, estou usando o Terminator), e digite o comando: curl --version. Se ele estiver instalado na máquina, retornará sua versão, como ilustra a figura abaixo:

Verificando a versão do Curl

Caso ele não esteja instalado, utilize o seguinte comando para instalar:

sudo apt-get install curl
Instalando o Curl e verificando a versão

Após instalado, você precisa escolher qual API irá usar. Como exemplo, vou utilizar uma API de Game of Thrones. Você pode ler a sua documentação completa neste link: https://anapioficeandfire.com/Documentation.

Como essa API é abertae só é possível realizar GETs, não é necessário credenciais para utilizá-la. Como exemplo, vou fazer um GET que retorne o conteúdo da API, ou seja, as informações que ela disponibiliza.

Fazendo o GET para a API

O primeiro retângulo indica o get realizado:

curl -s “https://www.anapioficeandfire.com/api" |jq

O retorno está no segundo retângulo:

{

“books”: “https://www.anapioficeandfire.com/api/books",

“characters”: “https://www.anapioficeandfire.com/api/characters",

“houses”: “https://www.anapioficeandfire.com/api/houses"

}

Note que no final do GET é utilizado o “JQ”. Essa aplicação serve para retornar os dados em Json organizados e, para instalar, você deve digitar no terminal sudo apt install jq.

Instalando o JQ

Concluindo, o Curl é um comando muito poderoso e muito útil, mas caso você não use Linux, ele está disponível para uso no Windows também, através do GIT Bash, e para obter mais informações neste artigo que ensina como instalar ele no Windows.

Se você ficou curioso para conhecer mais sobre a ferramenta de comando JQ para formatação do JSON, essa referência pode te ajudar a entender melhor como ele funciona.

--

--