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.
Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento de terminais físicos/ Gerenciamento de códigos de ativação/ Consulta de códigos de ativação por página como um administrador empresarial
Atualizado em 2023-08-02 GMT+08:00

Consulta de códigos de ativação por página como um administrador empresarial

Descrição

Esta API é usada por um administrador empresarial para consultar códigos de ativação por página. A consulta difusa por código de ativação ou nome do terminal é suportada.

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/usg/dcs/corp/vision/activecode

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

offset

Não

Integer

Consulta

Deslocamento de consulta. Se o valor exceder o número máximo de registros disponíveis, os registros na última página serão retornados.

Valor padrão: 0.

limit

Não

Integer

Consulta

Número de registros a serem consultados.

Valor padrão: 10.

searchKey

Não

String

Consulta

Critérios de pesquisa. Pesquisa difusa por código de ativação ou nome do terminal é suportada.

devType

Não

String

Consulta

Tipo de terminal.

  • huawei-vision: TV inteligente.
  • welink-desktop(iwb): quadro branco.
  • idea-hub: IdeaHub.

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.

X-Request-Id

Não

String

Cabeçalho

ID da solicitação, que é usado para rastreamento e localização de falhas. É aconselhável usar um UUID. Se este parâmetro não for transportado, um ID de solicitação é gerado automaticamente.

Accept-Language

Não

String

Cabeçalho

Idioma. Valores: zh-CN para chinês (padrão) e en-US para inglês.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é realizada ou falha.

403

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 exibidos por página.

Valor padrão: 10.

offset

Integer

Número da página inicial da consulta. O valor começa em 0.

data

Array of QueryVisionActiveCodeResultDTO objects

Informação do código de ativação por página.

Tabela 5 Estrutura de dados QueryVisionActiveCodeResultDTO

Parâmetro

Tipo

Descrição

activeCode

String

Código de ativação.

deptCode

String

Código do departamento.

deptName

String

Nome do departamento.

devName

String

Nome do terminal.

devType

String

Tipo de terminal.

expireDate

Long

Carimbo de data/hora de expiração.

id

String

ID exclusivo do código de ativação.

Exemplo de solicitação

GET /v1/usg/dcs/corp/vision/activecode
Connection: keep-alive
X-Access-Token: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD
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: Tue, 17 Dec 2019 09:32:47 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 639e8b710378987ffc5eb844b5e5c291

{
    "count": 1,
    "data": [
        {
            "activeCode": "324****97",
            "deptCode": "1",
            "deptName": "Test Department",
            "devName": "test_device",
            "devType": "idea-hub",
            "expireDate": 1611250137942,
            "id": "6d35397d67504dd1b7e1766a25f1be12"
        }
    ],
    "limit": 10,
    "offset": 0
}

Códigos de erro

Se um código de erro começando com MMC ou USG 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: stbWbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOD' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/vision/activecode