Categorías
Endpoint para listar las categorías de tu tienda via la API REST de Karrito.
#Listar categorías
GET /api/v1/categoriesRequiere autenticación con permiso read y acceso a la tienda. Devuelve { data, total, limit, offset }, ordenado por posición y, en caso de empate, por ID.
| Parámetro | Uso |
|---|---|
limit | Tamaño de página: predeterminado 50, máximo 100. |
offset | Filas que se omiten desde el inicio; se normaliza a un entero no negativo. |
status | active, inactive o all. Sin filtro se consultan activas. |
curl "https://karrito.app/api/v1/categories?status=all&limit=50" -H "Authorization: Bearer $KARRITO_API_KEY"#¿Qué campos recibo?
Cada categoría incluye id, name, slug, description, imageUrl y position. isActive se incluye cuando se proporciona explícitamente el filtro status. Un listado sin filtro no acredita que no existan categorías inactivas.
#Productos en varias categorías
Un producto puede pertenecer a varias categorías. En la API de productos, categoryIds representa sus pertenencias y categoryId conserva el alias de la primera categoría para compatibilidad. No uses ese alias como si describiera todas las pertenencias.
#Operaciones de escritura
La API también contempla creación, consulta individual, actualización y borrado de categorías. Las escrituras requieren products:write, acceso a la tienda y validación de sus límites. Consulta el contrato OpenAPI de la operación antes de enviar un cambio; listar categorías no autoriza borrarlas.
Consulta Autenticación, Productos y Categorías en el panel.