Etapa 1
Fundamentos de Design de APIs
Conceitos fundamentais independentes de linguagem.
Tópicos
- HTTP na prática
- Códigos de status e semântica
- Paginação, filtros e ordenação
- Idempotência e segurança básica
Backend
Design de APIs
Trilha focada em design, governança e qualidade de APIs, independente de linguagem.
Sequência sugerida de estudos
Cada módulo é um passo no seu aprendizado. Siga de cima para baixo, adaptando o ritmo à sua realidade.
-
-
Etapa 2
Contratos e Documentação
Como documentar e versionar APIs de forma sustentável.
Tópicos
- OpenAPI/Swagger
- Documentação orientada a casos de uso
- Estratégias de versionamento
- Depreciação de endpoints
Recursos sugeridos
-
Etapa 3
APIs em Ambientes Complexos
Quando lidar com gateways, rate-limits e segurança avançada.
Tópicos
- API Gateways
- Autenticação e autorização (OAuth2, JWT, etc.)
- Rate limiting e quotas
- SLOs para APIs
Recursos sugeridos
-
Etapa 4
Prática Guiada: Evoluir uma API Existente
Como pegar uma API já existente e melhorar seu design e experiência para clientes.
Tópicos
- Analisar endpoints existentes e identificar inconsistências
- Revisar códigos de status e mensagens de erro
- Melhorar paginação, filtros e ordenação
- Adicionar documentação navegável
- Planejar mudanças breaking com plano de migração
-
Etapa 5
Catálogo de APIs e Governança
Organizando o ecossistema de APIs de uma empresa.
Tópicos
- Catálogo de APIs e descoberta
- Guia de design interno (API style guide)
- Governança leve (review de contratos, linters)
- Métricas de uso de APIs (tráfego, erros, latência)
- Boas práticas de versionamento a longo prazo
Como usar esta trilha
Esta página não é um curso completo. Ela só organiza, em ordem, temas que fazem sentido estudar se você quer se aprofundar nesse assunto.
- Use a sequência como um mapa de referência, não como uma obrigação rígida.
- Procure conteúdos (vídeos, artigos, livros, documentações) para cada tópico listado.
- Adapte, pule ou reordene módulos conforme sua experiência e contexto.