Conteúdo

Edição atualizada em 08/2024.

Hoje em dia, muito se ouve falar de REST e se você desenvolve software já deve ter ouvido falar desse termo. Trata-se de um meio de realizar a comunicação entre dois sistemas diferentes, independente da linguagem em que tenham sido escritos. Existem muitas formas de se fazer isso, mas REST estabelece um conjunto de padrões que permite realizá-lo de forma eficiente e interoperável.

Neste livro, Alexandre Saudate aborda os serviços REST pelo viés prático, explicando os conceitos conforme vamos desenvolvendo uma aplicação ao longo do livro. Você vai aprender como criar um cliente para o serviço REST do Google Maps, além de como estabelecer relacionamentos, implementar testes e criar camadas de segurança. Na segunda parte do livro, você entrará ainda mais a fundo sobre APIs e até implementará algumas com ferramentas como o API Gateway da AWS e o Ngrok. Isso trará o conhecimento para que os serviços REST sejam realmente aproveitados, de modo a estarem prontos para os desafios que aparecerão uma vez que o grande público passe a utilizar sua aplicação.

Saiba o que você vai aprender

Sumário

Parte 1 — Serviços em REST

• 1 O que é REST, afinal?
• 1.1 Utilizando o Spring Boot para criar uma primeira API
• 1.2 O primeiro caso de uso: a listagem de novos motoristas
• 1.3 Quais são os métodos HTTP e como escolher entre eles?

• 2 Expandindo nosso serviço inicial
• 2.1 Recuperando os dados de um motorista específico
• 2.2 Conhecendo os códigos de status
• 2.3 Utilizando um cliente adequado - introdução ao Postman
• 2.4 Negociação de conteúdo
• 2.5 Enviando dados para o servidor
• 2.6 Idempotência: os efeitos de invocações sucessivas
• 2.7 Atualizando os dados enviados com PUT e PATCH
• 2.8 Apagando os dados de um determinado motorista

• 3 Criando relacionamentos entre recursos
• 3.1 Criando a API de passageiros
• 3.2 Criando a API de solicitação de viagens
• 3.3 Criação do serviço de solicitação de viagens
• 3.4 Inserindo links: primeiro uso de HATEOAS

• 4 Criando clientes REST
• 4.1 Reorganizando o projeto
• 4.2 Criando a chave de API do Google
• 4.3 Criando o código do cliente
• 4.4 Recuperando os dados com JSONPath
• 4.5 Integrando a consulta no projeto
• 4.6 Testando a nova API

• 5 Criando os testes automatizados
• 5.1 Conhecendo as estratégias de teste
• 5.2 Criando os testes da API de passageiros com REST Assured
• 5.3 Executando o teste
• 5.4 Testes mais completos com WireMock
• 5.5 Configuração do mock do Google Maps

• 6 Segurança
• 6.1 Conhecendo HTTPS
• 6.2 Implementando HTTPS na nossa API
• 6.3 Incluindo autenticação básica
• 6.4 Criando sistema de autorização
• 6.5 Carregando os usuários pelo banco de dados
• 6.6 Atualização dos testes integrados

Parte 2 - APIs

• 7 APIs
• 7.1 Como criar URLs significativas
• 7.2 Utilizar os códigos HTTP corretos
• 7.3 Fornecer mensagens de erro significativas
• 7.4 Internacionalizando as mensagens de erro
• 7.5 Como criar uma API retrocompatível (ou: como versionar uma API)

• 8 Documentando a API
• 8.1 Criando uma documentação viva com Swagger/OpenAPI
• 8.2 Utilizando o documenter do Postman

• 9 Outras técnicas
• 9.1 Paginação
• 9.2 CORS
• 9.3 OAuth
• 9.4 AWS API Gateway

• 10 Considerações finais

• 11 Referências bibliográficas