Como consumir uma API em Python com requests (do zero)

Introdução

Consumir APIs é uma das habilidades mais úteis para quem programa. É assim que aplicações buscam dados externos, se integram com outros sistemas e automatizam tarefas do mundo real.

Em Python, isso pode ser feito de forma bem simples com a biblioteca requests. Com poucas linhas de código, você já consegue fazer uma requisição, verificar se ela funcionou e começar a trabalhar com os dados retornados.

Neste post, você vai aprender o básico para consumir uma API em Python, entender a resposta e evitar alguns erros comuns.

O que é uma API

De forma simples, API é uma forma de comunicação entre sistemas.

Pensa assim:

• seu código faz uma requisição de alguma coisa (geralmente uma informação qualquer)

• um servidor responde com dados que tenham informações dessa "coisa" que você pediu

• normalmente em formato JSON (alguns casos podendo ser SOAP também)

Exemplo:

• App de clima → chama uma API.

• Backend → chama outra API.

• Sistema → integra com outro sistema.

Ou seja: praticamente todas as ferramentas que usamos hoje em dia consomem uma API.

Instalando a biblioteca

Pra consumir uma API em Python, vamos usar a biblioteca requests .
No seu terminal, escreve assim ó:

pip install requests

Fazendo sua primeira requisição

Agora vamos fazer uma requisição simples.

import requests

response = requests.get("https://jsonplaceholder.typicode.com/posts")

print(response.status_code)
print(response.json())

Tá... mas o que acabou de acontecer?

• requests.get(...) → faz a requisição HTTP

• response.status_code → mostra se deu certo ou não

  • 200 = sucesso (existem diversos códigos HTTP aqui nessa documentação dá uma olhadinha)

• response.json() → transforma a resposta em objeto Python

Trabalhando com os dados

Agora que temos os dados, podemos usa-los para qualquer coisa:

data = response.json()

for post in data[:5]:
    print(post["title"])

Aqui você já está:

• acessando dados retornados da API e guardando na variável data

• manipulando o dado

• iterando e exibindo os títulos dos posts

Erros comuns

Muita gente assume que sempre vai dar certo.

• Não verificar o status da resposta:

if response.status_code != 200:
    print("Erro na requisição")

• Assumir que sempre vem JSON válido, nem toda API responde corretamente e se você não tratar isso, o código pode quebrar.

• Não usar timeout. Sem timeout, sua aplicação pode travar esperando resposta.

response = requests.get("https://api.site.com", timeout=5)

Usar .text ao invés de .json()

# errado
print(response.text)

# correto
print(response.json())

Consumir APIs é uma habilidade essencial para qualquer desenvolvedor.

Com poucas linhas de código, você já consegue buscar dados externos, integrar sistemas e construir soluções reais.

A partir daqui, você pode evoluir para autenticação, APIs próprias e integrações mais complexas.