Ir al contenido
Fusehub
Grabaciones

Renovar el enlace de un clip

POST
/api/integration/v1/sites/{site_id}/recordings/clips/url

Da un enlace nuevo para un clip ya exportado cuando el anterior venció. No vuelve a generar el video. Solo sirve para clips que se entregaron como enlace.

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.

Cuerpo de la petición

application/json
  1. body
clipKey?|

Identificador del clip que devolvió la exportación.

clipId?|

Código del clip. Se puede enviar en lugar del anterior.

disposition?|

inline para reproducir en el navegador o attachment para descargar.

Por defecto"inline"
filename?|

Nombre del archivo al descargarlo.

expiresIn?|

Segundos que dura el enlace, entre 60 y 3600. Por defecto 900.

Cuerpo de la respuesta

OK

application/json
  1. response
clipKey*Clipkey

Identificador del clip.

downloadUrl*Downloadurl

Enlace nuevo para reproducir o descargar el clip.

expiresIn*Expiresin

Segundos que dura el enlace.

disposition*Disposition

inline (reproducción) o attachment (descarga).

contentType?Contenttype

Formato del archivo.

Por defecto"video/mp4"
[key: string]?any
Ejemplo de petición
curl -X POST 'https://api.staging.fusehub.lat/api/integration/v1/sites/string/recordings/clips/url' \  -H 'Content-Type: application/json' \  -d '{}'
Ejemplo de respuesta
{  "clipKey": "sites/site-id/recorder-clips/clip-id.mp4",  "downloadUrl": "https://s3.example/get?X-Amz-Signature=…",  "expiresIn": 900,  "disposition": "inline",  "contentType": "video/mp4"}

Exportar un clip POST

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.

Crear u obtener un clip POST

Saca del grabador el tramo pedido, cifrado, y lo guarda 90 días. El clip dura como máximo 10 minutos. Si ese mismo tramo ya existe, responde 200 con el mismo clip; si es nuevo, responde 201. El enlace de descarga se pide al abrir el clip.