Ir al contenido
Fusehub
Vídeo

Abrir un canal de voz

POST
/api/integration/v2/sites/{site_id}/devices/{device_id}/talk-sessions

Abre un canal para hablar por un intercomunicador, cámara o parlante con audio de dos vías. La respuesta trae los datos para enviar el micrófono (talkback) y la clave para cifrar la voz (key). Envía el keepalive antes de 5 minutos y cierra el canal al terminar. Responde 502 talk_uplink_failed si el canal está ocupado o el equipo no responde.

Autenticación

IntegrationKey
headerX-Integration-Key<token>

Tu clave de integración. Se crea en la consola de Fusehub, en Herramientas de desarrollo → API Keys.

Parámetros de la ruta

site_id*Site Id

Código de la sede.

device_id*Device Id

Código del equipo en Fusehub o su número de serie.

Encabezados

authorization?|

Token de espectador (Bearer …). Úsalo en lugar de la clave cuando la petición sale de una app o del navegador.

Cuerpo de la petición

application/json
  1. body
talkbackIdentity?Talkbackidentity

Nombre con el que hablas. Opcional.

Por defecto""

Cuerpo de la respuesta

OK

response?unknownapplication/json
Ejemplo de petición
curl -X POST 'https://api.staging.fusehub.lat/api/integration/v2/sites/string/devices/string/talk-sessions' \  -H 'Content-Type: application/json' \  -d '{}'
Ejemplo de respuesta
null

Emitir token de espectador POST

Llámalo desde tu servidor, nunca desde el navegador, porque usa la clave de integración. Devuelve un token de corta duración que el navegador envía como `Authorization: Bearer <token>` para ver vídeo, hablar, atender llamadas y ver clips. Si indicas equipos, el token solo sirve para ellos; si no, para toda la sede.

Mantener abierto el canal de voz POST

Envíalo antes de 5 minutos para que el canal no se cierre.