Skip to main content

Endpoint

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

Autenticacao

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

Parametros de rota

ParametroTipoObrigatorioDescricao
storeIdstringSimID da loja

Body

CampoTipoObrigatorioRegras
couponIdsstring[]Simarray com IDs unicos dos cupons da loja, na ordem final

Exemplo de requisicao

curl -X PUT "https://api.cabrapi.com.br/stores/STORE_ID/coupons/reorder" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "couponIds": [
      "COUPON_ID_3",
      "COUPON_ID_1",
      "COUPON_ID_2"
    ]
  }'

Resposta de sucesso (200)

{
  "status": true,
  "code": "COUPONS_REORDERED"
}

Possiveis erros

  • 400 INVALID_DATA -> payload invalido
  • 400 COUPON_LIST_INVALID -> um ou mais IDs nao pertencem a loja
  • 404 STORE_NOT_FOUND -> loja nao encontrada ou sem permissao
  • 500 INTERNAL_SERVER_ERROR -> erro interno

Observacoes

  • 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 consistencia.