Consulta de QoS de reuniones históricas
Descripción
- Esta API se utiliza para consultar QoS de reuniones históricas en una empresa.
- Puede consultar datos de los últimos tres meses por intervalo de tiempo.
- Rol de permisos = Empresa de edición Premium/Standard + Administrador
Depuración
Puede depurar esta API en API Explorer.
Prototipo
|
Método de solicitud |
GET |
|---|---|
|
Dirección de solicitud |
/v1/metrics/conferences/history |
|
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
|---|---|---|---|---|
|
startDate |
Sí |
Long |
Query |
Fecha de inicio de la consulta. El valor es una marca de tiempo Unix, en milisegundos. |
|
endDate |
Sí |
Long |
Query |
Fecha de finalización de la consulta. El valor es una marca de tiempo Unix, en milisegundos. |
|
offset |
No |
Integer |
Query |
Desplazamiento de consulta.
|
|
limit |
No |
Integer |
Query |
Número de registros a consultar.
|
|
searchKey |
No |
String |
Query |
El tema de la reunión, el programador y la ID de la reunión se pueden utilizar como palabras clave para la concordancia difusa. El valor contiene hasta 512 bytes. |
|
X-Access-Token |
Sí |
String |
Header |
Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación. |
Códigos de estado
|
Código de estado de HTTP |
Descripción |
|---|---|
|
400 |
Solicitud incorrecta. Parámetros no válidos. |
|
401 |
No autorizado. La autenticación no se realiza o falla. |
|
403 |
Prohibido. Permisos insuficientes. |
|
500 |
Excepción del servidor. |
Parámetros de respuesta
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
count |
Integer |
Número total de registros. |
|
limit |
Integer |
Número de registros consultados. |
|
offset |
Integer |
Desplazamiento de consulta. |
|
data |
Array of QosConferenceInfo objects |
Lista de reuniones históricas, que se ordenan por hora de inicio en orden descendente. Se pueden devolver hasta 500 registros. |
Ejemplo de solicitud
GET /v1/metrics/conferences/history?startDate=1617206400000&endDate=1618588800000&offset=0&limit=20&searchKey=Shenzhen Branch Connection: keep-alive X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC user-agent: WeLink-desktop Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
Ejemplo de respuesta
HTTP/1.1 200
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 2450
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 6fba0eff9f832b463580fb06c5b0ff9c
Server: api-gateway
X-Request-Id: ac9f75ec3c97c823f128526a924532b2
{
"count": 1,
"limit": 10,
"offset": 0,
"data": [{
"confUUID": "a3d9a31c8af211eb8075a12479434adb",
"conferenceID": "98909587",
"subject": "R&D Morning Call",
"scheduserName": "Secretary of Shenzhen Branch",
"deptName": "XXXXX",
"alarm": "YES",
"audioAlarm": "NO",
"videoAlarm": "YES",
"screenAlarm": "NO",
"cpuAlarm": "NO",
"timeZoneID": "56",
"startTime": 1618220740926,
"endTime": 1618222194202,
"duration": 32,
"participants": 52,
"webinar": false
}]
}
Códigos de error
Si se devuelve un código de error que comienza con MBI cuando usa esta API, corrija el error siguiendo las instrucciones proporcionadas en Centro de errores de la API de Huawei Cloud.
Ejemplo de comando cURL
curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d 'startDate=1617206400000&endDate=1618588800000' https://api.meeting.huaweicloud.com/v1/metrics/conferences/history
