APIAtividade Prática
Atividade prática · Desenvolvimento e publicação de uma API REST

API de Cadastro de Clientes e Gerenciamento de Produtos Favoritos

Construa uma API REST em JavaScript, com persistência no Cloudflare D1, consumo da Fake Store API e publicação no Cloudflare Workers.

JavaScript Cloudflare Workers Cloudflare D1 Wrangler Fetch API Fake Store API GitHub
11endpoints
2tabelas no D1
12requisitos técnicos
10,0pontos no total
01

Objetivo

Desenvolver uma API REST que permita o cadastro de clientes, a consulta de produtos provenientes de uma API externa e o gerenciamento de uma lista de produtos favoritos.

O projeto deverá utilizar banco de dados para persistência das informações, consumir uma API externa gratuita e ser publicado na plataforma Cloudflare.

02

Descrição do projeto

Você deverá desenvolver uma API que permita o cadastro de clientes e o gerenciamento de seus produtos favoritos. O sistema utilizará a Fake Store API como fonte externa de produtos.

Arquitetura da solução

Funcionamento esperado

  1. Um cliente realiza seu cadastro na aplicação.
  2. O sistema armazena os dados do cliente no banco de dados.
  3. O cliente pode consultar os produtos disponíveis na Fake Store API.
  4. O cliente pode selecionar produtos e adicioná-los à sua lista de favoritos.
  5. O sistema armazena os produtos favoritados e o relacionamento com o cliente no banco de dados.
  6. O cliente pode consultar e remover seus produtos favoritos.
03

Requisitos funcionais

3.1

Cadastro de clientes

MétodoEndpointDescrição
POST/clientsCadastrar um cliente
GET/clientsListar clientes
GET/clients/:idConsultar cliente por ID
PUT/clients/:idAtualizar cadastro
DELETE/clients/:idExcluir cliente

Dados mínimos do cliente:

  • ID
  • Nome
  • E-mail
  • Senha
🔒
A senha deverá ser armazenada utilizando hash, nunca em texto puro.
3.2

Integração com API externa

Consumir a Fake Store API para disponibilizar os produtos. Documentação: fakestoreapi.com/docs

MétodoEndpointDescrição
GET/productsListar produtos externos
GET/products/:idConsultar produto específico
GET/categoriesListar categorias
🌐
Os produtos deverão ser obtidos da API externa, sem necessidade de cadastrar previamente todos os produtos no banco local.
3.3

Gerenciamento de favoritos

MétodoEndpointDescrição
POST/clients/:id/favoritesAdicionar produto aos favoritos
GET/clients/:id/favoritesListar favoritos do cliente
DELETE/clients/:id/favorites/:productIdRemover produto dos favoritos
🔗
O banco de dados deverá armazenar o relacionamento entre clientes e produtos favoritos.
👤
Cada cliente deverá possuir sua própria lista de favoritos.
⛔
Não é permitido adicionar o mesmo produto duas vezes aos favoritos do mesmo cliente.
04

Requisitos técnicos

O projeto deverá atender aos seguintes requisitos:

  1. Utilizar JavaScript para desenvolver a API.
  2. Utilizar Cloudflare Workers para hospedagem.
  3. Utilizar Cloudflare D1 como banco de dados.
  4. Utilizar Wrangler para configuração e publicação.
  5. Consumir a Fake Store API utilizando Fetch API.
  6. Implementar operações CRUD para clientes.
  7. Implementar o gerenciamento de favoritos.
  8. Implementar validação dos dados recebidos.
  9. Implementar tratamento de erros.
  10. Utilizar códigos de status HTTP apropriados.
  11. Armazenar senhas utilizando hash seguro.
  12. Disponibilizar o código-fonte em um repositório público no GitHub.
05

Estrutura sugerida do banco de dados

O banco de dados deverá possuir, no mínimo, duas tabelas:

🔗
Deverão ser estabelecidas as relações entre as tabelas, garantindo que um cliente possa possuir vários produtos favoritos.
🔑
A combinação client_id + product_id deverá ser única.
06

Testes da API

Utilize Postman ou ferramenta equivalente para testar os itens abaixo. Marque cada um conforme for concluindo — o progresso fica salvo neste navegador.

0 de 10
07

Entregáveis

A entrega deverá conter obrigatoriamente:

📁1. Repositório GitHub

  • Link público do projeto.
  • Código-fonte completo.
  • Arquivo README.md.
  • Documentação dos endpoints.
  • Instruções de configuração e execução.

☁️2. API publicada na Cloudflare

  • URL pública da API em workers.dev.
  • Endpoints funcionando.
  • Integração com Cloudflare D1.
  • Consumo funcional da Fake Store API.
08

Forma de entrega

A entrega deverá ser realizada nesta atividade do Microsoft Teams, contendo:

1. Link do projeto no GitHub URL do repositório público.
https://github.com/usuario/projeto
2. Link da API publicada na Cloudflare URL pública da aplicação.
https://projeto.usuario.workers.dev
ℹ️
Não é necessário enviar arquivos compactados ou códigos-fonte diretamente no Teams.
09

Critérios de avaliação

CritérioPontuação
Cadastro e gerenciamento de clientes
1,5
Integração com a API externa de produtos
1,5
Implementação do gerenciamento de favoritos
2,0
Modelagem e persistência no Cloudflare D1
1,5
Publicação e funcionamento na Cloudflare
2,0
Validação, tratamento de erros e testes
1,0
Organização do GitHub e documentação
0,5
Total10,0
⚠️
Importante: a API deverá estar publicada e funcionando no momento da avaliação. A entrega apenas do código-fonte não será suficiente para concluir a atividade.