Skip to main content

​
Endpoint

PUT /stores/:storeId/categories/reorder Reordena as categorias da loja de acordo com a sequencia enviada em categoryIds.

​
Autenticacao

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

​
Parametros de rota

ParametroTipoObrigatorioDescricao
storeIdstringSimID da loja

​
Body

CampoTipoObrigatorioRegras
categoryIdsstring[]Simarray com IDs unicos das categorias da loja, na ordem final

​
Exemplo de requisicao

curl -X PUT "https://api.cabrapi.com.br/stores/STORE_ID/categories/reorder" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categoryIds": [
      "CATEGORY_ID_3",
      "CATEGORY_ID_1",
      "CATEGORY_ID_2"
    ]
  }'

​
Resposta de sucesso (200)

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

​
Possiveis erros

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

​
Observacoes

  • O endpoint GET /stores/:storeId/categories retorna as categorias ordenadas por position.
  • O frontend deve enviar a lista completa de IDs na ordem final para garantir consistencia.