Visão Geral

O Curso API Design for Developers ensina de forma prática e aprofundada como projetar, padronizar, documentar e implementar APIs modernas, com foco em boas práticas, escalabilidade e experiência do desenvolvedor (DX).

Durante o curso, os participantes aprenderão a modelar recursos, definir contratos de API, escolher estratégias de autenticação e versionamento, e documentar APIs de forma interativa usando OpenAPI (Swagger).
Além da teoria, o curso inclui laboratórios práticos para projetar e testar APIs que seguem os padrões RESTful e de mercado corporativo.

Objetivo

Após realizar este Curso API Design for Developers, você será capaz de:

• Entender os conceitos e princípios fundamentais de API Design.
• Projetar APIs RESTful claras, consistentes e escaláveis.
• Definir contratos de API e documentá-los com OpenAPI/Swagger.
• Implementar padrões de segurança e autenticação em APIs.
• Adotar boas práticas de versionamento, governança e consistência.
• Criar APIs centradas na experiência do desenvolvedor (DX).

Publico Alvo

• Desenvolvedores backend e frontend.
• Engenheiros e arquitetos de software.
• Profissionais DevOps e integradores de sistemas.
• Analistas técnicos e estudantes que desejam criar e manter APIs eficientes e bem estruturadas.

Pre-Requisitos

• Conhecimentos básicos em HTTP e JSON.
• Noções de programação em qualquer linguagem (ex: Java, Node.js, Python, .NET).
• Desejável experiência básica no consumo ou integração de APIs.

Materiais

Conteúdo Programatico

Módulo 1 – Fundamentos de API Design

1. O que é uma API e por que o design é essencial.
2. Tipos de APIs: REST, GraphQL, gRPC e Async APIs.
3. Ciclo de vida de uma API (planejamento, design, implementação e versionamento).
4. O papel do desenvolvedor no design de APIs.

Módulo 2 – Princípios de Arquitetura REST

1. Entendendo o modelo RESTful e seus princípios.
2. Recursos, endpoints e URIs bem projetadas.
3. Métodos HTTP (GET, POST, PUT, DELETE, PATCH).
4. Status Codes e mensagens de resposta padronizadas.

Módulo 3 – Modelagem de Recursos e Estrutura de Dados

1. Identificação e modelagem de recursos.
2. Estrutura de requests e responses.
3. Paginação, ordenação e filtragem.
4. Tratamento de erros e mensagens de exceção.

Módulo 4 – Contratos de API

1. O que é um contrato de API e sua importância.
2. Criando contratos com OpenAPI Specification (Swagger).
3. Definindo schemas e componentes reutilizáveis.
4. Evolução de contratos e versionamento sem quebra de compatibilidade.

Módulo 5 – Segurança e Autenticação

1. Padrões de segurança em APIs REST.
2. Autenticação com JWT, OAuth 2.0 e API Keys.
3. Autorização e controle de acesso a endpoints.
4. CORS, HTTPS e mitigação de ataques comuns (CSRF, injection).

Módulo 6 – Versionamento, Governança e Boas Práticas

1. Estratégias de versionamento (URI, Header, Query Param).
2. Padrões de nomenclatura e consistência.
3. Governança de APIs e políticas de controle.
4. Melhores práticas de performance, caching e escalabilidade.

Módulo 7 – Documentação e Ferramentas

1. Documentando APIs com Swagger UI, Postman e Redoc.
2. Criação de portais de API e onboarding de desenvolvedores.
3. Testes de APIs com Postman e integração contínua (CI/CD).
4. Monitoramento e métricas de uso da API.

Módulo 8 – Laboratório Prático e Projeto Final

1. Design de uma API completa a partir de requisitos reais.
2. Definição de recursos, contratos e versionamento.
3. Documentação e testes com Swagger e Postman.
4. Apresentação e discussão de soluções de design.