Pular para conteúdo

👽️ Como consumir uma API com Python

Para consumir uma API de forma simples com Python usaremos a biblioteca chamada requests.

🔧 Preparando o Ambiente

python3 -m venv .venv # (1)
source .venv/bin/activate # (2)
pip install requests # (3)
  1. Criando a virtualenv (⚠ Mude python3 para o PATH onde esta instalado o seu Python se for necessário)
  2. Ativando a virtualenv (MacOS e Linux)
  3. Instalando a biblioteca requests
poetry add requests # (1)
  1. Instalando a biblioteca requests with Poetry

⌨️ Código

Neste exemple vamos consumir a API que retornará um fato divertido aleatório e mostrar em tela.

consume_api.py
import requests # (1)


try:
    response = requests.get('https://api.aakhilv.me/fun/facts') # (2)
    response.raise_for_status() # (3)
    fun_fact = response.json()[0] # (4)
    print(f'Fun Fact: {fun_fact}') # (5)
except HTTPError as error: # (6)
    print(f'[{error.response.status_code}] {error}') # (7)
  1. Importando a biblioteca requests
  2. Realizando o get no enpoint /fun/facts na API
  3. Checando se a requisição retornou algum erro de status_code, caso de erro irá gerar uma exceção do tipo HTTPError (Linha 9 trata esta exceção)
  4. Converte o response para json e pega o primeiro elemento da lista de retorno
  5. Mostra em tela um fato divertido aleatório
  6. Se a linha 6 levantar uma exceção do tipo HTTPError, aqui ela será tratada
  7. Mostra em tela o status_code e o erro ocorrido

🚀 Rodando a Aplicação

python consume_api.py

🖼️ Saída

text

Comentários