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.
Duração: 3h30 Nível: Iniciante Pré-requisitos: Conhecimento básico de Python (funções, dicionários, listas)
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:
- 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
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.mdcom explicações detalhadas- Código comentado e funcional
- Exemplos de uso
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"git clone <url-do-repositorio>
cd tutorial-fast-apiuv syncPronto! O uv sync já criou o ambiente virtual e instalou todas as dependências.
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.pyNota: 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.
- Comece pela pasta
00-introducaopara entender o contexto - Leia o
README.mdde 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
Durante o tutorial, você vai aprender a testar suas APIs de forma visual e interativa:
-
🌐 Navegador - Para rotas GET simples
- Digite a URL e veja o JSON retornado
- Perfeito para testes rápidos
-
🎯 Swagger UI - Documentação interativa em
http://localhost:8000/docs- Teste todas as rotas (GET, POST, PUT, DELETE) clicando em botões
- Veja validações em tempo real
- Sem precisar instalar ferramentas extras
- Interface amigável para iniciantes!
Se você encontrar algum problema ou tiver dúvidas:
- Abra uma issue neste repositório
- Pergunte durante o tutorial na Python Brasil 2025
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! 🚀🐍