Skip to main content

​
📌 Endpoint

GET /stores/:storeId/categories Retorna todas as categorias de uma loja. As categorias sao retornadas na ordem de position (ascendente), ideal para montar menu/listagem no frontend.

​
🔐 Autenticação

  • Rota pública para consulta.
  • A loja vinculada ao storeId precisa estar com plano ativo.

​
🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja

​
✅ Exemplo de requisição

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/categories"

​
📦 Resposta de sucesso (200)

{
	"status": true,
	"code": "CATEGORIES_FETCHED",
	"categories": [
		{
			"id": "c6f0d28a-8ce2-4a8f-9771-4df1f2a7f3a1",
			"name": "Eletrônicos",
			"description": "Produtos eletrônicos em geral",
			"image": null,
			"position": 1,
			"storeId": "STORE_ID",
			"createdAt": "2026-03-02T20:00:00.000Z",
			"updatedAt": "2026-03-02T20:00:00.000Z"
		}
	]
}

​
⚠️ Possíveis erros

  • 400 INVALID_DATA → parâmetro inválido
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 404 CATEGORIES_NOT_FOUND → nenhuma categoria encontrada
  • 403 NO_ACTIVE_SUBSCRIPTION (ou similar) → plano inativo/expirado
  • 500 INTERNAL_SERVER_ERROR → erro interno