Objetivos: explicar por que um contrato estável deixa os times implantarem de forma independente; comparar REST, gRPC, GraphQL, WebSocket e mensageria e escolher um; projetar um recurso REST (URIs, métodos, códigos de status, erros, paginação); distinguir uma mudança incompatível de uma compatível e versionar quando preciso; documentar um serviço Spring Boot com OpenAPI e Swagger UI e decidir onde a documentação pode ficar exposta. Roteiro: (1) o contrato da API, estilos, Richardson; (2) design de APIs REST; (3) OpenAPI e Swagger.
Exercício Order API: 201 ao criar, 400 quando um item aponta para um produto inexistente, 404 (e não 403) para o pedido de outra pessoa — não revela que o pedido existe.