Skip to main content

​
📌 Endpoint

POST /stores/:storeId/categories Cria uma nova categoria para a loja informada.

​
🔐 Autenticação

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

​
🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja

​
🧾 Body

CampoTipoObrigatórioRegras
namestringSim4 a 32 caracteres
descriptionstringNão12 a 256 caracteres
imagestringNãoURL entre 12 e 512 chars

​
✅ Exemplo de requisição

curl -X POST "https://api.cabrapi.com.br/stores/STORE_ID/categories" \
	-H "Authorization: SUA_API_KEY" \
	-H "Content-Type: application/json" \
	-d '{
		"name": "Eletrônicos",
		"description": "Produtos eletrônicos em geral",
		"image": null
	}'

​
📦 Resposta de sucesso (201)

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

​
⚠️ Possíveis erros

  • 400 INVALID_DATA → payload inválido
  • 400 NAME_ALREADY_EXISTS → categoria com mesmo nome
  • 403 CATEGORY_LIMIT_REACHED → limite do plano atingido
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 500 INTERNAL_SERVER_ERROR → erro interno