Skip to main content

Endpoint

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

Autenticacao

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

Parametros de rota

ParametroTipoObrigatorioDescricao
storeIdstringSimID da loja

Body

CampoTipoObrigatorioRegras
productIdsstring[]Simarray com IDs unicos dos produtos da loja, na ordem final

Exemplo de requisicao

curl -X PUT "https://api.cabrapi.com.br/stores/STORE_ID/products/reorder" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": [
      "PRODUCT_ID_3",
      "PRODUCT_ID_1",
      "PRODUCT_ID_2"
    ]
  }'

Resposta de sucesso (200)

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

Possiveis erros

  • 400 INVALID_DATA -> payload invalido
  • 400 PRODUCT_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/products retorna os produtos ordenados por position.
  • O frontend deve enviar a lista completa de IDs na ordem final para garantir consistencia.