Saltar al contenido

Desarrolladores

Plataforma v1.0.7 · API v1 (ext. 1.1) · v2 con ETag

API pública (read-only)

Endpoint estable para integrar la agenda de queveohoy.es en apps, medios o dashboards. Respuesta JSON con CORS abierto en GET.

  • GET /api/v1/feed — eventos del día (Madrid). Opcional ?date=YYYY-MM-DD, ?limit=50, ?cursor=....
  • GET /api/v1/feed?categories=... — filtro por categorías (v1.1). IDs separados por coma: futbol, formula1, tv-reality, etc.
  • GET /api/v2/feed — feed v2 con cabecera ETag y respuesta 304 si envías If-None-Match. Mismos query params que v1.
  • GET /api/v1/search?q=... — búsqueda por texto (mín. 2 caracteres).
  • GET /api/v1/events/[id] — detalle de un evento por ID.
  • GET /api/health — estado del servicio y versión.
  • GET /api/feed-meta — frescura del feed y conteo de eventos.

Límite: 60 peticiones/minuto por IP. Cita queveohoy.es al reutilizar los datos.

curl "https://queveohoy.es/api/v1/feed"
curl "https://queveohoy.es/api/v1/feed?categories=futbol,formula1&limit=10"
curl -I "https://queveohoy.es/api/v2/feed"

Widgets embed

Incrusta prime time o accesos rápidos a categorías en tu web con iframes.

Qué ver esta noche

<iframe
  src="https://queveohoy.es/embed/esta-noche"
  title="Qué ver esta noche — queveohoy.es"
  width="420"
  height="520"
  loading="lazy"
  referrerpolicy="no-referrer-when-downgrade"
></iframe>

Categorías (v12)

<iframe
  src="https://queveohoy.es/embed/categorias"
  title="Categorías — queveohoy.es"
  width="420"
  height="360"
  loading="lazy"
></iframe>

Vista previa: esta noche · categorías

Design system — grupos neon (v10+)

Taxonomía visual para filtros y explorador. Tokens por grupo en app/lib/filter-groups-design.ts.

  • Deportes — accent #3aab6e, watermark «SPORT»
  • Motor — accent #f97316, watermark «MOTOR»
  • E-Sports — accent #a855f7, watermark «ESPORTS»
  • TV y Twitch — accent #d946ef, watermark «LIVE»
  • Cine, series y anime — accent #c9a227, watermark «CINEMA»

Explorador interactivo: /explorar. Deep link de filtros: /?filtros=futbol,tenis.

Documentación

Especificación completa en docs/API.md, roadmaps v11/v12 y organización del equipo.