Anuncios

Listar los anuncios

Anuncios publicados en su espacio de trabajo, con sus contadores de interacción.

Scope requerido announces:read

get/announcements

Autenticación

Authorizationstringobligatorio

Cabecera Authorization con una clave de API del espacio de trabajo, con la forma «Bearer kbn_live_…». La cabecera X-Api-Key se acepta de forma equivalente.

Parámetros de consulta

limitintegerpredeterminado 50

Tamaño de página. Limitado a [1, 200]: los valores fuera de rango se ajustan silenciosamente, nunca se rechazan.

min: 1 · max: 200

offsetintegerpredeterminado 0

Número de elementos a omitir. Mínimo 0.

min: 0

Respuesta200 · application/json

Una página de anuncios.

dataany[]obligatorio

The page of items.

paginationobjectobligatorio

Envoltorio de paginación por offset, compartido por todos los endpoints de lista paginados.

{ "data": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "title": "<string>", "content": "<string>", "type": "<string>", "teams": [ "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44" ], "app": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "startDate": "2026-09-01T09:12:03Z", "endDate": "2026-09-01T09:12:03Z", "createdAt": "2026-09-01T09:12:03Z", "updatedAt": "2026-09-01T09:12:03Z", "seenCount": 123, "likeCount": 123, "dislikeCount": 123, "likeRatio": 123 } ], "pagination": { "limit": 123, "offset": 123, "total": 123 } }