Anuncios
Administración de anuncios.
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/announcement 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 title | — |
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/announcement?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/announcement?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": "Campaña de lanzamiento",
"typ_id": "leader",
"title": "Conozca la nueva línea de servicios",
"url": "https://www.ejemplo.com/servicios",
"publish_since": "2026-11-01 00:00:00",
"publish_until": "2026-11-30 23:59:59"
}
},
"meta": {
"page": 1,
"per_page": 20,
"count": 1,
"total": 134
}
}GET /v1/announcement/{id} Obtener un registro ▶
Campos
| Campo | Etiqueta | Tipo |
|---|---|---|
name | — | texto |
title | — | texto |
subtitle | — | texto |
content | — | texto |
url | — | texto |
publish_since | — | fecha y hora |
publish_until | — | fecha y hora |
Componentes de la clave cat_id typ_id
curl -H "X-SYNCS-API-TOKEN: TU_TOKEN" "https://sandbox.minimarket.digital/v1/announcement/ID"Respuesta
{
"status": "success",
"code": "200",
"message": "GET",
"data": {
"id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
"name": "Campaña de lanzamiento",
"typ_id": "leader",
"title": "Conozca la nueva línea de servicios",
"url": "https://www.ejemplo.com/servicios",
"publish_since": "2026-11-01 00:00:00",
"publish_until": "2026-11-30 23:59:59"
}
}