Modelo de categoría de negocio
El recurso Category organiza los productos dentro de un negocio.
Operaciones principales
| Acción | Método | Recurso |
|---|---|---|
| Listar | GET | /business/{business_id}/categories |
| Consultar | GET | /business/{business_id}/categories/{category_id} |
| Crear | POST | /business/{business_id}/categories |
| Actualizar | POST | /business/{business_id}/categories/{category_id} |
| Eliminar | DELETE | /business/{business_id}/categories/{category_id} |
Las lecturas son públicas en el contrato del comportamiento descrito. Crear, actualizar y eliminar requieren autenticarse como administrador o administrador de negocio; las acciones del administrador de negocio están limitadas por comprobaciones de propiedad del negocio.
Campos representativos
Entre los campos comunes de categoría se incluyen id, business_id, name, description, image, header, rank, enabled, external_id, parent_category_id, slug, snooze_until y campos SEO. La disponibilidad y los requisitos de los campos varían según la operación, por lo que La documentación de cada operación define el contrato.
parent_category_id vincula una categoría con otra categoría del mismo negocio. La validación de categorías limita las cadenas de categorías padre a cinco niveles y rechaza categorías padre no válidas o demasiado profundas. Las lecturas de categorías pueden devolver subcategories anidadas; la respuesta exacta depende de la operación, los valores de consulta y la configuración del proyecto.
Usa params=products solo donde esté documentado para incluir productos con categorías. Consulta Expansión de productos de categoría y Modelo de producto de negocio.