Pular para o conteúdo principal
PUT
Reorder products

📌 Endpoint

PUT /stores/{storeId}/products/reorder Reordena os produtos da loja de acordo com a sequencia enviada em productIds.

🔐 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, array vazio, IDs duplicados ou elementos que não são UUIDs válidos
  • 400 PRODUCT_LIST_INVALID → um ou mais IDs não pertencem à loja
  • 401 API_KEY_NOT_PROVIDED → header Authorization não enviado (ou TOKEN_NOT_PROVIDED via Bearer)
  • 401 INVALID_API_KEY → API Key inválida (ou INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED via Bearer)
  • 403 USER_DISABLED → usuário desativado ou excluído
  • 403 NO_ACTIVE_SUBSCRIPTION → plano inativo ou expirado (ou PENDING_2FA via Bearer)
  • 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 ou banco de dados indisponível

📝 Observações

  • O endpoint GET /stores/{storeId}/products retorna os produtos 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 product IDs.

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

Resposta

Positions updated in provided order.

code
string
obrigatório
Exemplo:

"PRODUCTS_REORDERED"