Pular para o conteúdo principal
PUT
Reorder coupons

📌 Endpoint

PUT /stores/{storeId}/coupons/reorder Reordena os cupons da loja de acordo com a sequencia enviada em couponIds.

🔐 Autenticação

  • Rota privada.
  • Envie Authorization com sua API Key.

🧾 Parâmetros de rota


🧍 Body


✅ Exemplo de requisição


📦 Resposta de sucesso (200)


⚠️ Possíveis erros

  • 400 INVALID_DATA → payload inválido ou elementos que não são UUIDs válidos
  • 400 COUPON_LIST_INVALID → um ou mais IDs não pertencem à loja
  • 401 API_KEY_NOT_PROVIDED → header Authorization não enviado
  • 401 INVALID_API_KEY → API key inválida
  • 401 UNAUTHENTICATED → usuário não autenticado
  • 403 USER_DISABLED → usuário desativado
  • 403 NO_ACTIVE_SUBSCRIPTION → sem plano ativo
  • 404 STORE_NOT_FOUND → loja não encontrada ou sem permissão
  • 429 RATE_LIMIT_EXCEEDED → limite de requisições por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → erro interno
  • 503 SERVICE_UNAVAILABLE → serviço indisponível

📝 Observações

  • O endpoint GET /stores/{storeId}/coupons retorna os cupons ordenados por position.
  • O frontend deve enviar a lista completa de IDs na ordem final para garantir consistência.

Autorizações

Authorization
string
header
padrão:YOUR_API_KEY_HERE
obrigatório

Parâmetros de caminho

storeId
string
obrigatório
Required string length: 1 - 50

Corpo

application/json

Ordered coupon IDs.

couponIds
string<uuid>[]
obrigatório
Minimum array length: 1

Resposta

Positions updated in provided order.

code
string
obrigatório
Exemplo:

"COUPONS_REORDERED"