Ir al contenido
Fusehub
Parlantes

Reproducir audio

POST
/api/integration/v1/sites/{site_id}/speaker-audio-catalog/play

Reproducción en parlantes de la sede. Modo catálogo: JSON con catalogAudioId y serials o deviceIds. Modo efímero: query type=recorded (o custom) con multipart.

Autenticación

IntegrationKey
headerX-Integration-Key<token>

Clave de integración (fhint_…). Consola Fusehub → Herramientas de desarrollo → API Keys.

Parámetros de la ruta

site_id*Site Id

Parámetros de consulta

type?string|null

Cuerpo de la respuesta

OK

response?unknownapplication/json
Ejemplo de petición
curl -X POST 'https://api.staging.fusehub.lat/api/integration/v1/sites/string/speaker-audio-catalog/play'
Ejemplo de respuesta
null

Obtener entrada del catálogo GET

Detalle de una entrada del catálogo de audio.

Crear sesión talkback POST

Abre una room LiveKit compartida y arranca uplink ISAPI en cada parlante destino. **Targets:** `serials` y/o `deviceIds` (misma resolución que play de catálogo). **Flujo:** 1. `POST` esta ruta → `talkSessionId` + credenciales `talkback`. 2. SDK LiveKit: conectar a `talkback.url`, room `talkback.roomName`, token `talkback.token`, publicar micrófono. 3. `DELETE .../talk/session/{talkSessionId}` al terminar (obligatorio). Desconectar LiveKit (`Room.disconnect` / dejar de publicar mic) **no** cierra la sesión FuseHub ni el uplink ISAPI. **TTL:** 5 minutos. Sin `DELETE`, Core detiene el uplink automáticamente. **Room:** `site_{siteId}__talk_{talkSessionId}` — una sola room para todos los parlantes. **Éxito parcial:** HTTP 200 si al menos un uplink arranca; revisar `results[]`. HTTP 502 si ninguno arranca. **Requisitos:** parlante (`PARLANTE`), two-way audio, bridge conectado, LiveKit configurado.