Node.js: APIs RESTful e Coleção de Dados

Nesta aula vamos relembrar os conceitos básicos de APIs, tais como endpoints, verbos HTTP, códigos de retorno e formato JSON. Vamos também relembrar o conceito de coleções de dados.

Nesta aula daremos nosso primeiro passo na implementação de APIs que manipulam coleções de dados. Vamos construir uma API que retorna, através do verbo HTTP GET, uma coleção JSON com todas as UFs do Brasil.

Construiremos nessa aula o arquivo index.js da nossa aplicação de API. Vamos integrar nossa API com a coleção de dados, e retornar a lista de UFs completa após a requisição do cliente.

Evoluiremos nossa API para que retorne um registro específico da coleção. Criaremos uma nova rota no arquivo index.js, que terá o endpoint /ufs/:id, assim o cliente poderá consumir a coleção completa de dados.

Nesta aula vamos concluir a evolução no arquivo index.js. Iremos agora buscar a UF na coleção de dados e retornar um elemento específico para o cliente, através da segunda roda da API: https://localhost:8080/ufs/[ID-do-elemento].

Nesta aula aplicaremos o tratamento de erros na nossa API de UFS. Por exemplo, se o cliente consumir https://localhost:8080/ufs/99, a API deveria retornar o código de erro 404 (elemento não encontrado) - visto que não existe uma UF com esse ID.

Nesta aula vamos aplicar a funcionalidade de busca na nossa API de UFs. Por exemplo, se o cliente consumir https://localhost:8080/ufs?busca=rio, a API deve retornar as UFs “Rio de Janeiro”, “Rio Grande do Norte” e “Rio Grande do Sul”.

Nesta aula aplicaremos o conceito de separação de responsabilidades na API de UFs. A ideia é criar uma camada de serviços, separando a lógica central da API em um novo arquivo JavaScript.