Artigo 3 — Criando uma API Moderna com FastAPI (Dentro do Projeto com UV)

(Série: Construindo Projetos Python de Forma Profissional — Parte 3/4)

Por Leonardo Souza — Engenheiro de Software e Sistemas Embarcados

Introdução

Este é o terceiro artigo da série onde estamos construindo um projeto Python moderno, organizado e alinhado às práticas do mercado.

Se você não leu a Parte 2, recomendo ler antes, pois nela configuramos o projeto e o ambiente utilizando o Astral UV:

Gerenciando Ambientes Python com o Astral UV (Parte 2/4)

https://web.dio.me/articles/gerenciando-ambientes-python-com-o-astral-uv

No artigo anterior, estruturamos o projeto e garantimos um ambiente isolado e estável.

Agora vamos começar a desenvolver a aplicação em si, criando nossa primeira API usando FastAPI — de forma simples, direta e organizada.

Instalando o FastAPI

Dentro do projeto que criamos anteriormente:

cd meuprojetoapi

Instale o FastAPI:

uv add "fastapi[standard]"

Criando a Estrutura da API

Abra o arquivo main.py e substitua o conteúdo por:

from fastapi import FastAPI

app = FastAPI(title="Meu Projeto API")

@app.get("/")
def home():
  return {"message": "API rodando com sucesso!"}

Executando o Servidor da API

Para iniciar a API:

uv run fastapi dev main.py

Saída esperada:

Acesse:

BÔNUS — Criando Mais Endpoints

Agora, vamos enriquecer a API adicionando uma nova rota com parâmetro.

Substitua o main.py por:

from fastapi import FastAPI

app = FastAPI(title="Meu Projeto API")

@app.get("/")
async def read_root():
  return {
      "message": "Bem-vindo ao Meu Projeto API"
  }

@app.get("/itens/{item_id}")
async def read_item(item_id: int):
  return {
      "item_id": item_id,
      "message": "Item detalhado"
  }