Como criar uma API com Python: FastAPI passo a passo

Gabriel R. Cruz julho 25, 2026

Criar uma API com Python usando o FastAPI envolve instalar o framework e um servidor ASGI (como o Uvicorn), definir rotas utilizando type hints para validação automática de dados e executar o servidor para expor os endpoints. Em 2026, o processo exige o uso da versão Python 3.10 ou superior e foca estritamente nos modelos do Pydantic v2 para garantir alta performance, segurança na tipagem e a geração instantânea da documentação via Swagger UI.

Principais Aprendizados

  • O FastAPI atualmente exige Python 3.10+ e abandonou completamente o suporte ao Pydantic v1; o padrão obrigatório é o Pydantic v2.
  • A performance do framework se iguala a tecnologias concorrentes graças à arquitetura assíncrona e à validação de dados reescrita em Rust.
  • O erro mais comum entre iniciantes é bloquear a concorrência da API ao utilizar bibliotecas síncronas dentro de funções declaradas como async.

Por que o FastAPI dominou o desenvolvimento backend em 2026?

Como profissional com mais de duas décadas atuando em arquitetura de software, acompanhei a evolução dos frameworks web. O FastAPI não é apenas uma tendência passageira. Segundo dados da pesquisa Stack Overflow Developer Survey de 2025, o framework foi considerado o 'framework do ano', sendo o principal motor por trás do aumento de 7% no uso da linguagem Python globalmente.

A resposta para esse sucesso é um consenso na área: o FastAPI atinge um desempenho comparável a frameworks em Node.js e Go. Isso é um fato verificado, documentado pela documentação oficial (Tiangolo), e ocorre graças à sua base construída sobre o Starlette (para roteamento assíncrono) e o Pydantic (para validação).

Código Python do FastAPI na tela de um computador

Requisitos e Configuração Inicial

Antes de escrevermos a primeira linha de código, precisamos alinhar o ambiente às exigências atuais. O FastAPI amadureceu e deixou dependências legadas para trás.

De acordo com o changelog da LibHunt, a versão mais recente do FastAPI é a 0.139.0 (lançada em 1º de julho de 2026). Para rodar esta versão, o requisito mínimo é o Python 3.10. No entanto, para novos projetos em produção, a recomendação técnica é utilizar o Python 3.12 ou 3.13, aproveitando ao máximo os type hints avançados.

Passo a Passo: Criando sua primeira API

O primeiro passo é instalar as dependências. No seu terminal, execute:

pip install fastapi uvicorn

Em seguida, crie um arquivo chamado main.py. A tipagem no Python deixou de ser apenas uma boa prática de legibilidade e tornou-se a infraestrutura central. No FastAPI, é o tipo da variável que dita a validação de segurança e a formatação do formato JSON.

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    nome: str
    preco: float
    em_estoque: bool = True

@app.post("/itens/")
async def criar_item(item: Item):
    # Convertendo o modelo Pydantic v2 para dicionário
    item_dict = item.model_dump()
    return {"mensagem": "Item criado com sucesso", "dados": item_dict}

Para rodar o servidor, use o comando: uvicorn main:app --reload. Sua API estará disponível na porta 8000, com a documentação interativa pronta no endpoint /docs.

Diagrama de arquitetura do FastAPI com Pydantic v2 e Rust

O motor por trás da velocidade: Pydantic v2 e Rust

Um ponto crucial para projetos modernos: a partir da versão 0.128.0, o FastAPI removeu completamente o suporte de compatibilidade para o Pydantic v1. A integração com o Pydantic v2 é agora obrigatória. O motor de validação de dados foi reescrito em Rust, o que, segundo análises da Meshworld, trouxe ganhos imensos de velocidade na serialização em comparação com as versões anteriores escritas em Python puro.

Erros Fatais (e como evitá-los)

Na minha prática de consultoria, vejo desenvolvedores cometendo erros graves ao migrar para o FastAPI. O erro crítico mais comum é bloquear o Event Loop. Desenvolvedores iniciantes frequentemente usam bibliotecas síncronas (como a antiga requests) dentro de funções definidas como async def. Isso trava a concorrência da API inteira, gerando lentidão e até códigos HTTP de erro por timeout. O correto é usar bibliotecas assíncronas (como httpx) ou declarar a rota apenas como def.

Outro erro comum é usar sintaxe legada em tutoriais novos. Métodos como .dict() ou .parse_obj() estão obsoletos. Em 2026, o correto é usar .model_dump() e .model_validate().

Sinal de alerta sobre o bloqueio do event loop no Python

Consensos e Debates na Arquitetura

Diferente do Django (que possui ORM e painel embutidos), o FastAPI é um micro-framework. Há um debate contínuo na comunidade sobre a estrutura de pastas: usar arquiteturas baseadas em domínios (Domain-Driven Design) versus estruturas MVC tradicionais.

Minha opinião profissional é que a escolha do ORM dita muito dessa estrutura. Embora o SQLAlchemy 2.0 seja o consenso absoluto para aplicações de grande porte, o SQLModel (criado pelo mesmo autor do FastAPI) divide opiniões. Ele oferece integração nativa com o Pydantic, mas muitos arquitetos seniores o evitam em modelagens altamente complexas por considerá-lo menos maduro que o SQLAlchemy puro.

Perguntas Frequentes

O FastAPI substitui o Django?

Não. Isso é um mito comum. O FastAPI é focado na construção de APIs de alta performance. Ele não possui painel de administração nativo ou sistema de templates robusto out-of-the-box como o Django. São ferramentas para propósitos e arquiteturas diferentes.

Qual a versão do Python necessária para o FastAPI em 2026?

O FastAPI exige o Python 3.10 ou superior como versão mínima suportada. Para novos projetos, é altamente recomendado utilizar as versões 3.12 ou 3.13.

Por que meus métodos .dict() do Pydantic pararam de funcionar?

Porque o FastAPI removeu o suporte ao Pydantic v1 a partir da versão 0.128.0. No Pydantic v2, a sintaxe correta para converter modelos em dicionários é utilizar o método .model_dump().

Fontes

Tags
Gabriel R. Cruz

Postado por Gabriel R. Cruz

Postar um comentário

0 Comentários

Contact form