API order-lifecycle

O serviço expõe 176 rotas. Todas as de domínio ficam sob o prefixo /api/v2 (https://api.moldape.com/api/v2); as de saúde ficam na raiz. Os contratos detalhados (corpo e resposta) estão no Swagger do serviço quando ENABLE_SWAGGER=true (caminho em SWAGGER_PATH).

Acesso	Significado	Rotas
admin	requireAdmin(): sessão válida e role = admin	36
auth	requireAuth(): sessão válida, qualquer papel	125
pública	sem preHandler de autenticação	15

Cuidado

Linhas marcadas com ⚠️ são escritas (POST/PUT/PATCH/DELETE) em recursos de catálogo, conteúdo ou infraestrutura que não exigem admin. Ver R-02 e R-03.

Esta página é gerada por apps/docs/scripts/gen-api.mjs a partir de apps/order-lifecycle/src/presentation/routes/*.ts (última geração: 2026-10-16).

Sacola (carts)

Método	Rota	Acesso
POST	/carts	auth
POST	/carts/me	auth
GET	/carts/me	auth
GET	/carts/user/:userId	auth
POST	/carts/:id/items	auth
PUT	/carts/:id/items/:itemId	auth
DELETE	/carts/:id/items/:itemId	auth
DELETE	/carts/:id/items	auth
POST	/carts/:id/apply-coupon	auth
DELETE	/carts/:id/remove-coupon/:couponId	auth
POST	/carts/:id/convert-to-order	auth
PATCH	/carts/:id/apply-tax	auth
DELETE	/carts/:id/remove-tax	auth

Cupons

Método	Rota	Acesso
POST	/coupons	admin
GET	/coupons/:id	auth
PUT	/coupons/:id	admin
DELETE	/coupons/:id	admin
GET	/coupons	admin
GET	/coupons/validate/:code	auth

Coberturas

Método	Rota	Acesso
POST	/coverages	auth ⚠️
GET	/coverages/:id	auth
PUT	/coverages/:id	auth ⚠️
DELETE	/coverages/:id	auth ⚠️
GET	/coverages	auth
PUT	/coverages/:id/activate	auth ⚠️
PUT	/coverages/:id/deactivate	auth ⚠️
POST	/coverage-names	auth ⚠️
GET	/coverage-names	auth
GET	/coverage-names/:id	auth
PUT	/coverage-names/:id	auth ⚠️
DELETE	/coverage-names/:id	auth ⚠️
POST	/coverage-types	auth ⚠️
GET	/coverage-types	auth
PUT	/coverage-types/:id	auth ⚠️
DELETE	/coverage-types/:id	auth ⚠️
POST	/coverage-characteristics	auth ⚠️
GET	/coverage-characteristics	auth
PUT	/coverage-characteristics/:id	auth ⚠️
DELETE	/coverage-characteristics/:id	auth ⚠️
POST	/coverage-reinforcements	auth ⚠️
GET	/coverage-reinforcements	auth
PUT	/coverage-reinforcements/:id	auth ⚠️
DELETE	/coverage-reinforcements/:id	auth ⚠️
POST	/coverage-logo-configurations	auth ⚠️
GET	/coverage-logo-configurations	auth
GET	/coverage-logo-configurations/:id	auth
PUT	/coverage-logo-configurations/:id	auth ⚠️
DELETE	/coverage-logo-configurations/:id	auth ⚠️

Documentos

Método	Rota	Acesso
POST	/documents	admin
GET	/documents/:id	auth
PUT	/documents/:id	admin
DELETE	/documents/:id	admin
GET	/documents	pública

Rascunhos (drafts)

Método	Rota	Acesso
POST	/drafts	auth
GET	/drafts/:id	auth
PUT	/drafts/:id	auth
PATCH	/drafts/:id/customer-name	auth
DELETE	/drafts/:id	auth
GET	/drafts	admin
GET	/me/drafts	auth
POST	/drafts/:draftId/convert-to-cart	auth
POST	/drafts/:draftId/product	auth
POST	/drafts/:draftId/pieces	auth
DELETE	/drafts/:draftId/pieces	auth
PATCH	/drafts/:draftId/pieces/side	auth
DELETE	/drafts/:draftId/product	auth
DELETE	/drafts/:draftId/coverage	auth
POST	/drafts/:draftId/coverage	auth
POST	/drafts/:draftId/observations	auth
DELETE	/drafts/:draftId/observations	auth
PUT	/drafts/:draftId/observations	auth
PATCH	/drafts/:id/vector-state	auth
PATCH	/drafts/:draftId/plantigraphy/:side	auth
DELETE	/users/:userId/drafts	admin
PUT	/drafts/:id/creation-images	auth

Saúde (sem prefixo /api/v2)

Método	Rota	Acesso
GET	/health	pública
GET	/health/detailed	pública
GET	/health/redis	pública
GET	/health/cache/info	pública
DELETE	/health/cache/flush	pública ⚠️

Itens de suporte

Método	Rota	Acesso
POST	/help-info	pública ⚠️
GET	/help-info/:id	pública
GET	/help-info	pública
PUT	/help-info/:id	pública ⚠️
DELETE	/help-info/:id	pública ⚠️
PATCH	/help-info/:id/activate	pública ⚠️
PATCH	/help-info/:id/deactivate	pública ⚠️

Pedidos

Método	Rota	Acesso
POST	/orders	admin
GET	/orders/:id	auth
PUT	/orders/:id	admin
DELETE	/orders/:id	admin
GET	/orders	admin
GET	/me/orders	auth
GET	/orders/status/:status	admin
PATCH	/orders/:id/status	admin
PATCH	/orders/:id/shipping	admin
POST	/orders/:id/items	admin
PUT	/orders/:id/items/:itemId	admin
DELETE	/orders/:id/items/:itemId	admin
DELETE	/users/:userId/orders	admin
POST	/orders/:orderId/confirm-payment	admin

Pagamento

Método	Rota	Acesso
POST	/payments/create-payment-link	auth

Peças

Método	Rota	Acesso
POST	/pieces	auth ⚠️
GET	/pieces/:id	auth
PUT	/pieces/:id	auth ⚠️
DELETE	/pieces/:id	auth ⚠️
GET	/pieces	auth
POST	/piece-names	auth ⚠️
GET	/piece-names	auth
PUT	/piece-names/:id	auth ⚠️
DELETE	/piece-names/:id	auth ⚠️
POST	/piece-materials	auth ⚠️
PUT	/piece-materials/:id	auth ⚠️
DELETE	/piece-materials/:id	auth ⚠️
GET	/piece-materials	auth
POST	/piece-sizes	auth ⚠️
GET	/piece-sizes	auth
PUT	/piece-sizes/:id	auth ⚠️
DELETE	/piece-sizes/:id	auth ⚠️
POST	/piece-sides	auth ⚠️
PUT	/piece-sides/:id	auth ⚠️
DELETE	/piece-sides/:id	auth ⚠️
GET	/piece-sides	auth
PUT	/pieces/:id/activate	admin
PUT	/pieces/:id/deactivate	admin

Produtos

Método	Rota	Acesso
POST	/products	auth ⚠️
GET	/products/:id	auth
GET	/products/code/:code	auth
PUT	/products/:id	admin
DELETE	/products/:id	admin
GET	/products	auth
PUT	/products/:id/activate	admin
PUT	/products/:id/deactivate	admin
POST	/product-names	admin
PUT	/product-names/:id	admin
DELETE	/product-names/:id	admin
GET	/product-names	auth
POST	/product-types	admin
PUT	/product-types/:id	admin
DELETE	/product-types/:id	admin
GET	/product-types	auth
GET	/product-types/:id	auth
POST	/product-characteristics	auth ⚠️
GET	/product-characteristics/:id	auth
GET	/product-characteristics	auth
PUT	/product-characteristics/:id	auth ⚠️
DELETE	/product-characteristics/:id	auth ⚠️
POST	/product-sizes	auth ⚠️
GET	/product-sizes	auth
GET	/product-sizes/:id	auth
PUT	/product-sizes/:id	auth ⚠️
DELETE	/product-sizes/:id	auth ⚠️

Slide show

Método	Rota	Acesso
POST	/slide-shows	auth ⚠️
GET	/slide-shows/:id	pública
GET	/slide-shows	pública
PATCH	/slide-shows/:id	auth ⚠️
DELETE	/slide-shows/:id	auth ⚠️

Taxas e formas de envio

Método	Rota	Acesso
POST	/taxes	admin
GET	/taxes/:id	auth
PUT	/taxes/:id	admin
DELETE	/taxes/:id	admin
GET	/taxes	auth

Uploads

Método	Rota	Acesso
POST	/upload/plantigraphy	auth
POST	/upload/products	auth ⚠️
POST	/upload/creation-image	auth
POST	/upload/pdf	auth
POST	/upload/docs	auth ⚠️
POST	/upload/banners	auth ⚠️
POST	/upload/coverages	auth ⚠️
POST	/upload/pieces	auth ⚠️
POST	/upload/diagnose-pdf	auth
DELETE	/upload/plantigraphy/:filename	auth
POST	/upload/chunk	auth
POST	/upload/chunk/complete	auth
POST	/upload/coverage-logos	auth ⚠️
DELETE	/upload/chunk/:sessionId	auth