Catálogo API v1
Categorías
Árbol de 3 niveles: department → category → subcategory. El nivel se infiere del padre — solo envías parent_id. No se puede crear un 4.º nivel ni saltar niveles.
Campos
| Campo | Tipo | Notas | |
|---|---|---|---|
name | string | req | |
slug | string | req | Único entre hermanas |
parent_id | number | Sin parent = nivel department | |
sort_order | integer | ||
is_active | boolean | Default true |
La respuesta incluye el campo calculado level (1 department / 2 category / 3 subcategory).
Endpoints
Lista de categorías. Filtros: parent_id, level (1, 2 o 3), is_active.
Request
{
"name": "Aceites",
"slug": "aceites",
"parent_id": 5
} Response 201
{
"id": 23,
"name": "Aceites",
"slug": "aceites",
"parent_id": 5,
"level": 2,
"sort_order": 0,
"is_active": true
} Edita name, slug, sort_order, is_active. El parent_id no se puede mover.
409 si tiene productos o subcategorías activas asociadas.
Devuelve los atributos de la categoría más los heredados de todas sus categorías padre.