API de testes com dados mockados para desenvolvimento local.
- Node.js 18+ (ou Bun/Yarn/Pnpm)
cd api
# com npm
npm install
# ou com yarn
# yarn
# ou com pnpm
# pnpm install# modo desenvolvimento (hot reload)
npm run dev
# build + produção
npm run build
npm startServidor padrão em http://localhost:3001.
-
GET
/— healthcheck -
Users:
GET /usersGET /users/:idPOST /usersPUT /users/:idDELETE /users/:id
-
Products:
GET /productsGET /products/:idPOST /productsPUT /products/:idDELETE /products/:id
-
Posts:
GET /postsGET /posts/:idPOST /postsPUT /posts/:idDELETE /posts/:id
-
Professionals (rotas dedicadas para profissionais):
GET /professionals(query:service,city,minRating,maxPrice,sort)GET /professionals/:idGET /professionals/:id/working-hoursGET /professionals/:id/diary(query:dateopcional)GET /professionals/:id/availability(query:dateobrigatório YYYY-MM-DD)GET /professionals/search/nearby(query:lat,lng,radius,service)GET /professionals/service/:category(query:cityopcional)
Dados iniciais em db.json. As mutações são in-memory (não persistem no arquivo).
- Arquivo da collection:
mock-api.postman_collection.json
- Abra o Postman e vá em: File → Import (ou clique em Import no topo).
- Selecione o arquivo
mock-api.postman_collection.json(arrastar e soltar também funciona). - A collection aparecerá como
mock-apino sidebar.
- A collection já define variáveis:
protocol,host,port,baseUrl,userId,productId,postId. baseUrlé montado automaticamente a cada requisição a partir deprotocol,hosteport(ex.:http://localhost:3001).- Para alterar a porta/host, ajuste as variáveis da própria collection (ícone de olho → Edit).
- Execute
Health Checkpara validar que a API está respondendo. - Rode os requests de
List(GET) para ver os dados iniciais. - Crie um recurso com
Create(POST). Oidretornado é salvo automaticamente nas variáveis (userId,productId,postId). - Em seguida, rode
Update(PUT) eDelete(DELETE) — os requests usam o:ida partir dessas variáveis.
- Cada request possui testes básicos (status code, tipo de resposta e campos esperados).
- As requisições
Createsalvam oidretornado em variáveis para encadearUpdate/Deletesem edição manual.