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 com a linguagem e o framework de sua escolha, com persistência no Cloudflare D1, consumo da Fake Store API e publicação no Cloudflare Workers.

Linguagem e framework à sua escolha Cloudflare Workers Cloudflare D1 Wrangler Fake Store API GitHub ★ Desafio opcional: front-end
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 a linguagem e o framework de sua preferência para desenvolver a API, desde que compatíveis com o Cloudflare Workers.
  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 por meio de requisições HTTP (ex.: 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.
10

Desafio extra: visão de front-end

★ Opcional · para quem desejar

Além da API, desenvolva uma interface web que consuma os endpoints que você criou, permitindo que um usuário utilize o sistema sem precisar do Postman. O desafio não faz parte dos critérios de avaliação acima.

  • 📝Cadastro de clienteFormulário com nome, e-mail e senha, validação dos campos e mensagens de erro claras.
  • 🛍️Catálogo de produtosListagem dos produtos com imagem, título e preço, e filtro por categoria.
  • 🔍Detalhe do produtoPágina ou modal com descrição completa e botão para favoritar.
  • ❤️Meus favoritosLista dos favoritos do cliente, com opção de remover cada item.
  • 👤Gerenciar cadastroEdição e exclusão dos dados do cliente.
  • ⚠️Feedback ao usuárioEstados de carregamento, mensagens de sucesso e erro (ex.: produto já favoritado).

Sugestões técnicas

  • Framework livre: React, Vue, Svelte, Angular ou HTML/CSS/JS puro.
  • Layout responsivo (funcionar bem no celular).
  • Hospedagem no Cloudflare Pages.
  • Habilitar CORS na API para aceitar requisições do front-end.

Como entregar

  • Código no mesmo repositório (ex.: pasta frontend/) ou em um repositório separado.
  • Instruções de execução no README.md.
  • Enviar, junto com a entrega no Teams, o link público do front-end (ex.: https://projeto.pages.dev).