Categorías
Administración de categorías.
Este recurso sólo se consulta: su contenido lo calculan los procesos del sistema. POST, PUT, PATCH y DELETE responden 405 READ_ONLY.
GET /v1/category Listar registros ▶
| Parám. | Descripción | Defecto |
|---|---|---|
page | Número de página | 1 |
per_page | Registros por página (máx. 1000) | 20 |
since | Inicio del rango de creación (columna entered). Solo fecha = desde las 00:00:00 | — |
until | Fin del rango de creación. Solo fecha = hasta las 23:59:59 | — |
q | Búsqueda de texto en los campos indicados en cada recurso: name description | — |
s / o | Campo de ordenamiento · Sentido: asc o desc | según recurso |
f | Filtros exactos en JSON | — |
# página 2, 20 por página
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/category?page=2&per_page=20"
# creados en un rango de fechas, más recientes primero
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/category?since=2026-07-01&until=2026-07-31&s=entered&o=desc"
Respuesta
{
"status": "success",
"code": "200",
"message": "LIST",
"data": {
"a1b2c3d4-5e6f-7890-abcd-ef1234567890": {
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"name": "Actualidad",
"mnu_id": "art",
"lng_id": "es_pe",
"order": 1,
"slug": "actualidad"
}
},
"meta": {
"page": 1,
"per_page": 20,
"count": 1,
"total": 134
}
}
GET /v1/category/{id} Obtener un registro ▶
Campos
| Campo | Etiqueta | Tipo |
|---|---|---|
name | — | texto |
description | — | texto |
parent | — | referencia a Categorías |
order | — | número |
color | — | texto |
ico | — | texto |
slug | — | texto |
Componentes de la clave lng_id mnu_id
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/category/ID"
Respuesta
{
"status": "success",
"code": "200",
"message": "GET",
"data": {
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"name": "Actualidad",
"mnu_id": "art",
"lng_id": "es_pe",
"order": 1,
"slug": "actualidad"
}
}