Exportar un clip
Saca un tramo de la grabación de una cámara como video MP4. El clip dura como máximo 10 minutos.
Indica la cámara por su número de serie, o por el número de serie del grabador y el canal. Indica el tiempo de una de dos formas: un momento (eventTime) con segundos antes y después, o un inicio y un fin.
Por defecto recibes un enlace de descarga que vence; con base64 o binary recibes el archivo en la respuesta, y ese clip no se puede renovar después.
IntegrationKeyX-Integration-Key<token>Tu clave de integración. Se crea en la consola de Fusehub, en Herramientas de desarrollo → API Keys.
site_id*Site IdCódigo de la sede.
application/json- body
serial?|Número de serie de la cámara. Si no lo tienes, envía el grabador y el canal.
recorderSerial?|Número de serie del grabador. Obligatorio con el canal, o si la cámara está en más de un grabador.
channelNo?|Canal del grabador, desde 1. Requiere el número de serie del grabador.
eventTime?|Momento del evento (ISO-8601, con o sin zona horaria). No se combina con inicio y fin.
startTime?|Inicio del clip (ISO-8601). Va junto con el fin.
endTime?|Fin del clip (ISO-8601). Máximo 600 segundos después del inicio.
timeZone?|Zona horaria de las fechas, por ejemplo America/Bogota. Si no se envía, se usa la del grabador.
secondsBefore?|Segundos antes del evento, hasta 300. Antes y después suman como máximo 600.
secondsAfter?|Segundos después del evento, hasta 600. Antes y después suman como máximo 600.
format?|mp4-h264 se reproduce en casi cualquier navegador. mp4-hevc sale más rápido, pero no todos los navegadores lo reproducen.
"mp4-h264"filename?|Nombre del archivo al descargarlo.
responseMode?|Cómo recibir el clip: url enlace de descarga (por defecto), base64 archivo dentro del JSON, binary el video como respuesta.
disposition?|inline para reproducir en el navegador o attachment para descargar (por defecto). No aplica a base64.
Clip creado.
- response
deviceId?|Código de la cámara en Fusehub.
recorderDeviceId?|Código del grabador en Fusehub.
channelNo?|Canal del grabador.
durationSec?|Duración del clip en segundos.
downloadUrl?|Enlace para reproducir o descargar el clip. Vence.
clipKey?|Identificador del clip para renovar el enlace.
expiresIn?|Segundos que dura el enlace.
disposition?|inline (reproducción) o attachment (descarga).
exportPlan?ClipExportPlan|nulltimings?ClipExportTimings|nullclipBase64?|El video en base64, cuando el clip viene dentro de la respuesta.
bytes?|Tamaño del video en bytes, cuando viene en base64.
timeZone?|Zona horaria usada.
utcOffsetMinutes?|Diferencia con UTC de esa zona, en minutos.
[key: string]?anycurl -X POST 'https://api.staging.fusehub.lat/api/integration/v1/sites/string/recordings/clips/export' \ -H 'Content-Type: application/json' \ -d '{}'{ "deviceId": "00000000-0000-4000-8000-000000000012", "recorderDeviceId": "00000000-0000-4000-8000-000000000099", "channelNo": 4, "durationSec": 18, "downloadUrl": "https://s3.example/get?X-Amz-Signature=…", "clipKey": "sites/site-id/recorder-clips/clip-id.mp4", "expiresIn": 900, "disposition": "attachment"}