Pular para o conteúdo principal
PUT
Reorder stores

📌 Endpoint

PUT /stores/reorder Reordena as lojas da conta autenticada de acordo com a sequencia enviada em storeIds.

🔐 Autenticação

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

🧍 Body


✅ Exemplo de requisição


📦 Resposta de sucesso (200)


⚠️ Possíveis erros

  • 400 INVALID_DATA → payload inválido
  • 400 STORE_LIST_INVALID → um ou mais IDs não pertencem à conta
  • 401 API_KEY_NOT_PROVIDED → header Authorization não enviado
  • 401 INVALID_API_KEY → API Key inválida ou não encontrada
  • 401 UNAUTHENTICATED → sessão/usuário não autenticado
  • 403 USER_DISABLED → conta do usuário desativada ou excluída
  • 403 NO_ACTIVE_SUBSCRIPTION → conta sem plano ativo
  • 429 RATE_LIMIT_EXCEEDED → limite de requisições por minuto do plano excedido
  • 500 INTERNAL_SERVER_ERROR → erro interno
  • 503 SERVICE_UNAVAILABLE → serviço temporariamente indisponível

📝 Observações

  • O endpoint GET /stores retorna as lojas ordenadas 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

Corpo

application/json
storeIds
string<uuid>[]
obrigatório
Minimum array length: 1

Resposta

Positions updated in provided order.

code
string
obrigatório
Exemplo:

"STORES_REORDERED"