Obtener Grabaciones
Punto final: /recording/fetch
Parámetros de Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| room_ids | array | Sí | Array de IDs de sala para obtener grabaciones. |
| from | number | No | Índice de inicio para los registros. El valor predeterminado es 0. |
| limit | number | No | Número máximo de registros a devolver. El valor predeterminado es 20. |
| order_by | string | No | Orden de clasificación: DESC o ASC. El valor predeterminado es DESC. |
Ejemplo de Solicitud:
{
"room_ids": ["room01"],
"from": 0,
"limit": 20,
"order_by": "DESC"
}
Respuesta
| Campo | Tipo | Posición | Descripción |
|---|---|---|---|
| status | boolean | raíz | Indica si la solicitud fue exitosa. |
| msg | string | raíz | Mensaje de respuesta. |
| result | object | raíz | Contiene los datos de las grabaciones. |
Resultado
| Campo | Tipo | Descripción |
|---|---|---|
| total_recordings | number | Número total de grabaciones encontradas. |
| from | number | Índice de inicio para los registros devueltos. |
| limit | number | Número de registros devueltos. |
| order_by | string | Orden de clasificación utilizado para los registros. |
| recordings_list | Array<Información de la Grabación> | Lista de registros de grabaciones. |
Información de la Grabación
| Campo | Tipo | Descripción |
|---|---|---|
| record_id | string | Identificador único para la grabación. |
| room_id | string | ID de la sala asociada con la grabación. |
| room_sid | string | SID de la sala. |
| file_path | string | Ruta al archivo de grabación. |
| file_size | number | Tamaño del archivo de grabación en bytes. |
| creation_time | number | Hora de creación de la grabación (marca de tiempo Unix). |
| room_creation_time | number | Hora de creación de la sala (marca de tiempo Unix). |
| metadata | Objeto de Metadatos de Grabación | Metadatos asociados con la grabación. |
Objeto de Metadatos de Grabación
| Campo | Tipo | Descripción |
|---|---|---|
| title | string | El título de la grabación. |
| description | string | La descripción de la grabación. |
| subtitles | map Objeto de Subtítulo de Grabación | Un mapa de códigos de idioma a objetos de subtítulos. p. ej. {"en": {"url": "..."}} |
| extra_data | map | Un mapa de datos adicionales almacenados con la grabación. p. ej. {"key": "value"} |
Objeto de Subtítulo de Grabación
| Campo | Tipo | Descripción |
|---|---|---|
| label | string | La etiqueta para el subtítulo. |
| url | string | La URL del archivo de subtítulos. |