Mostrar eventos en tu propia web (feed de eventos)

Si quieres mostrar además tus eventos en tu propia web, con tu propio diseño y no como una página incrustada de Univents, puedes habilitar eventos concretos para ello. Univents los sirve entonces a través de un feed público de solo lectura que tu web (o la de tu agencia) puede consultar y mostrar por su cuenta.

Mostrar un evento en la web

La habilitación se hace directamente en el evento, no de forma centralizada en un único sitio:

1. Abre el evento que quieras.
2. En la cabecera de la vista de detalle, haz clic en el interruptor Mostrar en la web.
3. Univents guarda el cambio al instante y lo confirma con un breve mensaje.

Con el interruptor activado, el evento aparece en el feed en unos minutos. Si lo desactivas de nuevo o eliminas el evento, desaparece del feed igual de automáticamente. El interruptor afecta solo a ese evento: no existe una habilitación masiva para todos los eventos a la vez.

Qué incluye el feed

El feed entrega únicamente datos pensados para mostrarse en un calendario público: título, descripción, hora de inicio y de fin, si la fecha ya es definitiva, lugar del evento, imagen de portada, etiquetas, un enlace a la venta de entradas (si el evento tiene una página de entradas publicada; en borrador faltan el enlace y el precio), así como el precio de entrada más barato que aún está disponible y un indicador de «Agotado». Datos internos como el presupuesto interno, el número de invitados, notas, datos de contacto, estado o datos financieros nunca aparecen en el feed, independientemente de si el evento está publicado. Tampoco salen del sistema los cupos, los nombres de las categorías ni las cifras de venta: hacia fuera solo va el precio y la información «Agotado» sí/no.

Precio desde y Agotado

Si vendes entradas a través de Univents, el feed ofrece dos datos adicionales con los que tu web puede construir un «desde 25 €» y un «Agotado»:

• price_from: el precio de entrada más barato que un visitante todavía puede comprar, como importe bruto (es decir, lo que figura en la categoría de la tienda de entradas). Si tu categoría más barata se agota, pasa automáticamente a mostrarse la siguiente más cara. Así, la web nunca promete un precio que ya no existe en la tienda.
• price_from_currency: la moneda de tu Workspace como código, p. ej. EUR o CHF.
• tickets_sold_out: true en cuanto no se puede comprar ninguna categoría de entradas. Mientras alguna categoría aún tenga entradas, el valor sigue siendo false, aunque algunas categorías ya estén completas.

Si todo está agotado, price_from queda vacío (null): un precio «desde» junto a «Agotado» invitaría a una compra que no es posible. Un evento sin venta de entradas devuelve price_from: null y tickets_sold_out: false: no vende nada, así que tampoco puede estar agotado.

Si anulas una entrada, la plaza vuelve a quedar libre al instante: la categoría vuelve a poder comprarse y reaparece en el precio «desde». Como el feed se guarda en caché durante un breve tiempo, un evento que acaba de agotarse puede seguir apareciendo como disponible en tu web durante unos minutos.

Imagen y descripción: las del evento, no las de la página de entradas

Para el calendario de la web cuentan la imagen y la descripción del propio evento, es decir, lo que mantienes en el evento en Presentación. La imagen y la descripción de una página de reservas o de entradas pertenecen a esa página y no pasan automáticamente al calendario de la web. Es intencionado: muchos negocios muestran adrede un motivo distinto en la tienda de entradas que en el calendario de su propia web.

Si quieres que ambas coincidan, tienes que indicarlo una vez:

1. Abre la página de reservas o de entradas y entra en la sección Detalles.
2. Bajo la imagen y la descripción encontrarás el aviso con el botón Aplicar también al calendario del sitio web.
3. Confirma la pregunta. La imagen y la descripción de la página se copian entonces al evento vinculado, y los datos que hubiera allí hasta ese momento se sobrescriben.

El botón solo aparece cuando la página está vinculada a un evento (en las páginas de entradas siempre es así). Se aplica el último estado guardado de la página, y los campos que estén vacíos en la página se quedan sin cambios en el evento, de modo que una página vacía nunca te borra una imagen. Hasta que el cambio llegue al calendario de la web pueden pasar unos minutos, porque el feed se guarda brevemente en caché.

El tamaño con el que se muestra la imagen lo decide vuestra web: Univents entrega la imagen en su tamaño original.

Consultar el feed

El feed es público y se puede consultar sin inicio de sesión ni clave de API: una web o una herramienta externa puede cargarlo directamente con fetch:

GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}

dein-workspace es el slug de tu Workspace, que también encuentras en la barra de direcciones de tu navegador, detrás de /home/. Con los parámetros from y to acotas el periodo, y con limit el número de resultados (por defecto 50, máximo 100). limit se ajusta a tres niveles (25, 50 o 100) para que la caché se las arregle con pocas respuestas: un valor solicitado siempre se redondea al nivel superior más próximo; por ejemplo, ?limit=10 devuelve 25 resultados igual que ?limit=25, y todo lo que supere 100 se limita a 100. Sin indicar nada, el feed devuelve todos los eventos habilitados a partir de hoy.

Un ejemplo de respuesta tiene este aspecto:

{
  "workspace": "dein-workspace",
  "count": 2,
  "events": [
    {
      "id": "…",
      "title": "Sommerkonzert",
      "description": "…",
      "start": "2026-08-20T18:00:00Z",
      "end": "2026-08-20T23:00:00Z",
      "date_is_confirmed": true,
      "venue": "Großer Saal",
      "image_url": "https://…",
      "tags": ["Konzert"],
      "ticket_url": "https://univents.app/book/dein-workspace/deine-seite",
      "price_from": 25,
      "price_from_currency": "EUR",
      "tickets_sold_out": false,
      "updated_at": "2026-08-05T09:00:00Z"
    }
  ]
}

Para desarrolladores y agencias

El feed está pensado a propósito para integrarse directamente en una web existente sin tener que gestionar credenciales:

• Sin autenticación ni clave de API: la ruta es de acceso público, pero devuelve exclusivamente los eventos del Workspace correspondiente que tengan el interruptor activado.
• CORS está abierto: una consulta con fetch funciona directamente desde el navegador de cualquier web.
• En caché: las respuestas se pueden guardar en caché durante poco tiempo (unos minutos) para que las consultas frecuentes sigan siendo rápidas. Por eso, un evento recién habilitado no aparece al instante, sino en unos minutos.
• Con límite de peticiones: si se hacen muchísimas consultas en poco tiempo desde el mismo origen, la ruta responde con un error en lugar de con datos vacíos; para un uso normal de una web esto no es relevante.
• Un slug de Workspace desconocido devuelve un error, no una lista vacía, así notas enseguida si el slug es incorrecto.

Preguntas frecuentes

¿Veo en el feed también espacios que solo están ocupados pero no publicados? No. El feed muestra exclusivamente eventos en los que has activado el interruptor Mostrar en la web, nunca la ocupación general de tus espacios.

¿Incluye el feed precios? Sí, uno: el precio de entrada más barato que aún está disponible (price_from, bruto) junto con la moneda. La lista de precios completa sigue estando solo en la página de reservas a la que apunta ticket_url.

¿Por qué mi web muestra un precio más alto que ayer? Porque la categoría más barata ya se ha agotado. El feed indica siempre el precio más barato que todavía se puede comprar, no el más barato que haya existido alguna vez.

¿Por qué mi evento sin entradas no aparece como «Agotado»? Porque no vende entradas. tickets_sold_out solo es true cuando hay venta de entradas y ya no queda nada en ella.

¿Tengo que habilitar cada evento por separado? Sí, de momento no existe una habilitación masiva. El interruptor está a propósito en cada evento por separado, para que tengas control total sobre lo que es visible públicamente.

¿Está la función ligada a un plan concreto? El feed muestra únicamente lo que tú mismo habilitas: no hay requisitos adicionales más allá del permiso normal de eventos.

¿Me cuesta algo consultar el feed? No, el feed es un acceso de solo lectura a datos que ya has habilitado, por lo que no se generan costes adicionales.