Criando uma API em Python do Zero

#Flask
#Python
#API

No mundo da tecnologia, APIs estão em todo lugar. Elas permitem que sistemas conversem entre si e troquem dados de forma padronizada. Se você já usou um aplicativo de clima, pediu comida por delivery ou fez login com Google/Facebook, pode ter certeza: uma API estava por trás disso.

Neste post, vamos entender o que é uma API e como criar a sua primeira API em Python de forma simples.

🔹 O que é uma API?

API significa Application Programming Interface.

De forma resumida, é um conjunto de regras que permite que um software interaja com outro.

Na web, isso normalmente acontece via HTTP, retornando dados em JSON.

Exemplo:

O iFood consulta a API do restaurante para saber o cardápio.
O app de banco acessa a API do sistema financeiro para mostrar seu saldo.

🔹 Por que usar Python?

Python é uma das linguagens mais populares para APIs por ser:

✅ Simples de escrever e ler

✅ Cheia de bibliotecas para web (Flask, FastAPI, Django REST)

✅ Muito usada em análise de dados, machine learning e integrações

Aqui vamos usar o Flask, que é leve e perfeito para quem está começando.

🔹 Criando a primeira API com Flask

Aqui vamos criar uma API simples, sem o uso de banco de dados, apenas como um exercício para entendermos melhor como funciona Ok?

1. Instalar o Flask

pip install flask

2. Criar o arquivo `app.py`

from flask import Flask, jsonify, request

app = Flask(__name__)

# Rota raiz
@app.route("/")
def home():
  return jsonify({"mensagem": "Bem-vindo à minha primeira API em Python!"})

# Rota que retorna lista de usuários
@app.route("/usuarios", methods=["GET"])
def listar_usuarios():
  usuarios = [
      {"id": 1, "nome": "Ana"},
      {"id": 2, "nome": "Bruno"},
      {"id": 3, "nome": "Carla"}
  ]
  return jsonify(usuarios)

# Rota que recebe parâmetro
@app.route("/usuario/<int:id>", methods=["GET"])
def buscar_usuario(id):
  usuarios = {
      1: "Ana",
      2: "Bruno",
      3: "Carla"
  }
  if id in usuarios:
      return jsonify({"id": id, "nome": usuarios[id]})
  return jsonify({"erro": "Usuário não encontrado"}), 404

# Rota que recebe dados via POST
@app.route("/criar", methods=["POST"])
def criar_usuario():
  dados = request.json
  return jsonify({
      "mensagem": "Usuário criado com sucesso!",
      "usuario": dados
  }), 201

if __name__ == "__main__":
  app.run(debug=True)