Tutorial FastAPI - Python Brasil 2025
Bem-vindo ao tutorial "Começando com FastAPI: construa sua primeira API em Python"!
Este é um tutorial prático e introdutório onde você vai aprender a criar sua primeira API REST usando FastAPI, um dos frameworks mais modernos e rápidos para desenvolvimento de APIs em Python.
Sobre o Tutorial
Duração: 3h30
Nível: Iniciante
Pré-requisitos: Conhecimento básico de Python (funções, dicionários, listas)
Sobre o Instrutor
Felipe de Morais (FeliPython)
Senior Software Engineer com vários anos de experiência em desenvolvimento de software, especializado em criar e desenvolver projetos web de larga escala. Co-fundador da AfroPython, uma iniciativa que promove diversidade e inclusão na comunidade tech brasileira.
Reconhecimentos:
- 🏅 PSF Fellow - Python Software Foundation (2024)
- 🏆 PSF Community Service Award - Q2 2019
- 🏵️ Prêmio Dorneles Treméa/Jean Ferri - Associação Python Brasil (2020)
Felipe tem mais de 12 anos de experiência com construção de soluções para internet e vem trabalhando há quase 2 anos com FastAPI, é apaixonado por testes, desenvolvimento de APIs e por fazer a comunidade Python crescer através de ensino e contribuições open source.
Contato:
O que você vai aprender
- Criar seus primeiros endpoints (GET, POST)
- Validar dados de entrada com Pydantic
- Usar a documentação automática gerada pelo FastAPI
- Testar sua API localmente
- Organizar seu código de forma profissional
Estrutura do Tutorial
Este tutorial está organizado em 6 etapas progressivas:
- 00-introducao - O que são frameworks web e a história do FastAPI
- 01-hello-world - Sua primeira API em 5 linhas de código
- 02-rotas-get - Criando rotas GET com parâmetros
- 03-rotas-post - Recebendo dados com POST
- 04-validacao-pydantic - Validação automática de dados
- 05-organizando-codigo - Estruturando seu projeto
Cada etapa contém:
README.md com explicações detalhadas
- Código comentado e funcional
- Exemplos de uso
Setup Inicial
1. Instalar o uv (gerenciador de pacotes Python)
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
2. Clonar ou baixar este repositório
git clone <url-do-repositorio>
cd tutorial-fast-api
3. Criar ambiente virtual e instalar dependências
uv sync
Pronto! O uv sync já criou o ambiente virtual e instalou todas as dependências.
4. Executar os exemplos
Use uv run para executar os comandos a partir da raiz do projeto (não precisa fazer cd ou ativar o ambiente virtual):
uv run fastapi dev 01-hello-world/main.py
Nota: Se preferir, você também pode ativar o ambiente virtual manualmente com source .venv/bin/activate (Linux/Mac) ou .venv\Scripts\activate (Windows) e rodar os comandos diretamente.
Como usar este tutorial
- Comece pela pasta
00-introducao para entender o contexto
- Leia o
README.md de cada etapa
- Execute o código (a partir da etapa 01)
- Experimente modificá-lo
- Passe para a próxima etapa quando se sentir confortável
Testando as APIs
Durante o tutorial, você vai aprender a testar suas APIs de forma visual e interativa:
Recursos Adicionais
Suporte
Se você encontrar algum problema ou tiver dúvidas:
- Abra uma issue neste repositório
- Pergunte durante o tutorial na Python Brasil 2025
Próximos Passos
Após completar este tutorial, você pode explorar:
- Conexão com banco de dados (SQLAlchemy)
- Autenticação e autorização (OAuth2, JWT)
- Deploy em produção (Railway, Render, Fly.io)
- Testes automatizados (pytest)
- Async/await para operações concorrentes
Bom aprendizado! 🚀🐍