Marcas
Listar marcas
GET /api/v1/catalog/brands
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
cursor | string | Cursor de paginación |
limit | int | Items por página (default 25) |
q | string | Búsqueda por nombre |
Respuesta 200:
{
"data": [
{
"id": "uuid",
"name": "Mi Marca",
"slug": "mi-marca",
"description": "Descripción de la marca",
"color": "#FF5733",
"logo_url": "https://cdn.omnibuy.io/...",
"website_url": "https://mimarca.com",
"product_count": 15
}
],
"meta": { "pagination": { "cursor": "eyJ...", "has_next": true } }
}
Crear marca
POST /api/v1/catalog/brands
{
"name": "Mi Marca",
"slug": "mi-marca",
"description": "Marca líder en tecnología",
"color": "#FF5733",
"logo_media_id": "uuid-de-imagen",
"website_url": "https://mimarca.com"
}
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
name | sí | string | Nombre de la marca |
slug | no | string | URL-friendly |
description | no | string | Descripción |
color | no | string | Color hexadecimal |
logo_media_id | no | uuid | Logo (subir primero via media API) |
website_url | no | string | Sitio web |
Respuesta 201: objeto Brand completo.
Obtener marca
GET /api/v1/catalog/brands/:id
Devuelve el objeto Brand completo.
Actualizar marca
PUT /api/v1/catalog/brands/:id
Mismos campos que crear. Omite los que no quieras cambiar.
Eliminar marca
DELETE /api/v1/catalog/brands/:id
Respuesta 204 No Content