Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2023-08-02 GMT+08:00

Consulta de QoS de reuniões históricas

Descrição

  • Esta API é usada para consultar QoS de reuniões históricas em uma empresa.
  • Você pode consultar dados dos últimos três meses por intervalo de tempo.
  • Função de permissão = edição empresarial Premium/Standard

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

GET

Endereço de solicitação

/v1/metrics/conferences/history

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

startDate

Sim

Long

Consulta

Data de início da consulta. O valor é um carimbo de data/hora Unix, em milissegundos.

endDate

Sim

Long

Consulta

Data de fim da consulta. O valor é um carimbo de data/hora Unix, em milissegundos.

offset

Não

Integer

Consulta

Deslocamento da consulta.

  • O valor é maior ou igual a 0. O valor padrão é 0.
  • Se o valor for maior ou igual ao número máximo de registros, os dados na última página serão retornados.

limit

Não

Integer

Consulta

Número de registros a serem consultados.

  • Intervalo de valores: 1 a 500. O valor padrão é 20.

searchKey

Não

String

Consulta

O tópico da reunião, o agendador e o ID da reunião podem ser usados como palavras-chave para correspondência difusa. O valor contém até 512 bytes.

X-Access-Token

Sim

String

Cabeçalho

Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

400

Solicitação inválida. Parâmetros inválidos.

401

Não autorizado. A autenticação não é executada ou falha.

403

Proibido. Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

count

Integer

Número total de registros.

limit

Integer

Número de registros consultados.

offset

Integer

Deslocamento da consulta.

data

Array of QosConferenceInfo objects

Lista de reuniões históricas, que são classificadas por hora de início em ordem decrescente. Até 500 registros podem ser retornados.

Exemplo de solicitação

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)

Exemplo de resposta

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 erro

Se um código de erro começando com MBI for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo 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