🛰️O que são APIs, como funcionam e como usar no Python

#API

🌌 Projeto CodeVerse Python - #31/2025

👋 Fala, galera dev! 🚀

Chegamos a mais um artigo da nossa jornada no Projeto CodeVersePython2025!

Hoje vamos falar sobre um tema que parece complexo quando escutamos pela primeira vez, mas que, quando a gente entende, vê que é bem mais simples do que parece: APIs.

Vamos fazer isso de um jeito bem leve, explindo a forma técnica, mas também mostrando de uma forma bem lúdica e simples para que serve e para que usaremos as famosas APIs em nosso projeto J.A.R.V.I.S. Neste artigo vou mostrar apenas uma dessas APIs, mas existem diveresas APIs, desde pagas até as gratuitas que nos fornecem diversos tipos de serviços que podmeos integrar aos nossos projetos.

❓O que é uma API?

Tecnicamente falando, API significa Application Programming Interface. Em bom português, ela é uma interface que permite que dois programas diferentes conversem entre si. É como um conjunto de regras combinadas para que um software consiga pedir informações para outro software e receber a resposta de volta.

Antes de ir para exemplos, imagine que existe um sistema que cuida de várias coisas nos bastidores (backend) e outro que é a parte que você vê (frontend). Esses dois mundos não se comunicam diretamente e, para isso, usam um "tradutor": a API.

Agora, vamos usar a analogia do restaurante para facilitar ainda mais:

🍽️ Frontend: é tudo o que você vê na frente do restaurante. Mesas, cardápio, garçons, a decoração. É a parte bonita, o que aparece para o cliente.
👨🍳 Backend: é a cozinha. Lá dentro os cozinheiros trabalham com os ingredientes, fazem combinações, preparam tudo, mas ninguém que está sentado na mesa vê como é feito.
🛎️ API: é o garçom. Ele é o responsável por levar o seu pedido da mesa até a cozinha, esperar que fique pronto e depois trazer o prato para você. Tudo isso sem você precisar ir lá dentro.

Com os sistemas é a mesma coisa: a API leva o pedido do usuário para o sistema que vai processar tudo e devolve a resposta pronta.

💡Curiosidade sobre APIs

As APIs modernas começaram a se popularizar nos anos 2000. Empresas como Google, Amazon e Salesforce criaram APIs para que outros desenvolvedores conseguissem integrar seus serviços de forma simples e segura. Com o tempo, isso virou algo gigantesco. Hoje, praticamente tudo que usamos na internet, de apps de banco até redes sociais, passa por alguma API.

🌦️Usando a API do OpenWeather no Python (gratuita)

Vamos ver um exemplo prático usando a API gratuita do OpenWeather, que fornece dados de previsão do tempo.

1️⃣ Criar uma conta e pegar a chave (API Key)

Acesse https://openweathermap.org/api
Crie uma conta gratuita.
Faça Login no site para aparecer a opção chaves de API
No seu perfil, copie sua API Key (uma espécie de senha).

Site da OpenWeather - local onde é gerada sua chave API

2️⃣Fazer uma requisição no Python

Agora vamos criar um pequeno programa que consulta a previsão do tempo usando essa API.

# Importa a biblioteca que permite fazer chamadas na API pela internet.
import requests


# aqui você coloca sua chave única obtida no site do OpenWeather.
API_KEY = "SUA_CHAVE_AQUI"
# a cidade que você quer consultar.
CIDADE = "São Paulo"
# é o endereço completo que a API espera. Aqui adicionamos o nome da cidade, a chave, a linguagem e que queremos a temperatura em Celsius.
url = f"https://api.openweathermap.org/data/2.5/weather?q={CIDADE}&appid={API_KEY}&lang=pt_br&units=metric"


# aqui fazemos a requisição para a API.
resposta = requests.get(url)
# transformamos a resposta em um formato fácil de usar no Python.
dados = resposta.json()


# verificamos se a API respondeu com sucesso.
if resposta.status_code == 200:
  # pegamos a temperatura.
  temperatura = dados['main']['temp']
  # pegamos a descrição do clima.
  descricao = dados['weather'][0]['description']
  # mostramos a informação para o usuário.
  print(f"A temperatura em {CIDADE} é {temperatura}°C com {descricao}.")
else:
  # Caso aconteça algum erro, mostramos a mensagem abaixo:
  print("Erro ao buscar os dados da API")

Código acima executado no VS Code

🧠Conclusão

As APIs são como pontes que conectam dois mundos diferentes. Elas foram criadas para facilitar a comunicação entre sistemas e hoje fazem parte de tudo que a gente usa na internet. No Projeto CodeVersePython2025, vamos usar APIs como essa para dar superpoderes ao nosso Jarvis: com elas, poderemos pedir por voz a previsão do tempo e receber as informações rapidamente, mas isso vou mostrar um pouco mais para frente.

Por enquanto vamos apenas ver o que são as famosas APIs e entender como elas facilitam nossas vidas. Fazendo com que sistemas diferentes, e até mesmo com linguagens de programação diferentes conversem entre si. As APIs são simples e poderosas. Saber usá-las é um passo importante para sair do básico e começar a integrar seus projetos com serviços reais. 🚀

Gostou deste conteúdo? Então me siga no GitHub e no LinkedIn para acompanhar mais artigos, projetos e a evolução do CodeVersePython2025.

Vamos aprender juntos e transformar esse projeto em algo incrível! 💡