Skip to main content

📌 Endpoint

GET /stores/:storeId/categories/:categoryId Retorna uma categoria específica da loja, incluindo produtos e cupons relacionados.

🔐 Autenticação

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

🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja
categoryIdstringSimID da categoria

✅ Exemplo de requisição

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/categories/CATEGORY_ID" \
	-H "Authorization: SUA_API_KEY"

📦 Resposta de sucesso (200)

{
	"status": true,
	"code": "CATEGORY_FETCHED",
	"category": {
		"id": "CATEGORY_ID",
		"name": "Eletrônicos",
		"description": "Produtos eletrônicos em geral",
		"image": null,
		"position": 1,
		"storeId": "STORE_ID",
		"products": [],
		"coupons": [],
		"createdAt": "2026-03-02T20:00:00.000Z",
		"updatedAt": "2026-03-02T20:00:00.000Z"
	}
}

⚠️ Possíveis erros

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