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 usuário/ APIs/ Consulta de detalhes pessoais como um usuário
Atualizado em 2023-08-02 GMT+08:00
Ver PDF

Consulta de detalhes pessoais como um usuário

Descrição

Esta API é usada por um usuário empresarial para consultar detalhes pessoais.

SLA

Taxa de sucesso de solicitação: > 99,99%

Atraso na solicitação TP99: 133 ms

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/member

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

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 é executada 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

activeTime

Long

Tempo de ativação (carimbo de data/hora UTC).

adminType

Integer

Tipo de administrador.

  • 0: administrador padrão (super).
  • 1: administrador comum.
  • 2: membro comum da empresa (Esse valor é válido somente quando UserType é definido como 2.)

corp

CorpBasicInfoDTO object

Detalhes de registro da empresa, que são retornados apenas quando os usuários consultam os dados pessoais de si mesmos.

country

String

País ou região ao qual o número de celular do usuário pertence.

deptCode

String

Código do departamento.

deptName

String

Nome do departamento.

deptNamePath

String

Caminho do nome do departamento.

desc

String

Observações.

devType

QueryDeviceInfoResultDTO object

Tipo do dispositivo associado.

email

String

Endereço de e-mail.

englishName

String

Nome em inglês.

function

UserFunctionDTO object

Sinalizador de função do usuário.

hidePhone

Boolean

Seja para esconder o número de celular.

id

String

ID do usuário.

license

Integer

Licença.

  • 0: utilização comercial.
  • 1: avaliação gratuita.

name

String

Nome do usuário.

phone

String

Número de celular.

signature

String

Assinatura.

sipNum

String

Número do SIP.

sortLevel

Integer

Número de sequência no diretório empresarial. Um valor menor indica uma posição mais alta no diretório empresarial.

status

Integer

Estado do usuário.

  • 0: normal.
  • 1: desativado.

thirdAccount

String

ID de usuário de terceiros.

title

String

Título do trabalho.

userAccount

String

Conta do Huawei Cloud Meeting.

userType

Integer

Tipo de usuário.

2: membro da empresa.

visionAccount

String

Conta exclusiva da TV inteligente.

vmrList

Array of UserVmrDTO objects

Lista de salas de reunião na nuvem.
Tabela 5 Estrutura de dados UserVmrDTO

Parâmetro

Tipo

Descrição

id

String

ID de sala de reunião na nuvem.

NOTA:

Ele corresponde ao vmrID na API para criar uma reunião.

vmrId

String

ID da reunião fixo da sala de reunião na nuvem.

NOTA:

Ele corresponde a vmrConferenceID na resposta de chamar a API para criar uma reunião.

vmrName

String

Nome de sala de reunião na nuvem.

vmrMode

Integer

Modo de sala de reunião na nuvem.

  • 0: ID da reunião pessoal.
  • 1: sala de reuniões em nuvem.
  • 2: webinar.

vmrPkgId

String

ID do pacote de sala de reunião na nuvem. Esse parâmetro é retornado somente para salas de reunião na nuvem.

vmrPkgLength

Integer

Duração da reunião do pacote de sala de reunião na nuvem. Se o valor for 0, a duração da reunião é ilimitada. Esse parâmetro é retornado somente para salas de reunião na nuvem.

vmrPkgName

String

Nome do pacote de sala de reunião na nuvem. Esse parâmetro é retornado somente para salas de reunião na nuvem.

vmrPkgParties

Integer

Número de participantes simultâneos no pacote de sala de reuniões na nuvem. Esse parâmetro é retornado somente para salas de reunião na nuvem.

status

Integer

Status da sala de reunião na nuvem.

  • 0: normal.
  • 1: desativado.
  • 2: não alocado.
Tabela 6 Estrutura de dados CorpBasicInfoDTO

Parâmetro

Tipo

Descrição

account

String

Conta de administrador.

address

String

Endereço da empresa.

adminName

String

Nome do administrador.

autoUserCreate

Boolean

Se o registro automático do usuário está ativado.

country

String

País ou região a que pertence o número de telemóvel do administrador.

email

String

Endereço de e-mail do administrador.

enablePstn

Boolean

Se a PSTN está ativada.

enableSMS

Boolean

Se enviar notificações de reunião por mensagem SMS.

id

String

ID da empresa.

name

String

Nome da empresa.

phone

String

Número de telemóvel do administrador.

enableCloudDisk

Boolean

Se o Clouddrive está ativado.

corpType

Integer

Tipo de empresa.

Exemplo de solicitação

GET /v1/usg/dcs/member
Connection: keep-alive
X-Access-Token: stbLRonxHFt7jfbMHSY2UufNZewbPwb8TP8y
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: 812
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: c94f64967745b0670c299c0688479078
Server: api-gateway
X-Request-Id: de796b739528b6a1f72c283a107bdb02

{
    "id": "ff808081699b56cb0169b81a06ee00d9",
    "userAccount": "user8001@corpnew",
    "name": "test008",
    "englishName": null,
    "phone": null,
    "country": null,
    "email": "user8001@corpnew.com",
    "sipNum": "+991116003840",
    "vmrList": [
        {
            "id": "ff808081699b56cb0169b81a06f400db",
            "vmrId": "913371462",
            "vmrName": "user8001's cloud meeting room",
            "vmrMode": 0,
            "vmrPkgId": null,
            "vmrPkgName": null,
            "vmrPkgParties": null,
            "vmrPkgLength": null,
            "status": 0
        },
        {
            "id": "ff808081699b56cb0169b92b45ab0111",
            "vmrId": "919728047",
            "vmrName": "Cloud meeting room 919728047",
            "vmrMode": 1,
            "vmrPkgId": "ff808081680d5b8601682b3436070030",
            "vmrName": "Dedicated operations cloud meeting room_25",
            "vmrPkgParties": 25,
            "vmrPkgLength": 0,
            "status": 0
        }
    ],
    "deptCode": "1",
    "deptName": "wangyue",
    "deptNamePath": "wangyue",
    "userType": 2,
    "adminType": 2,
    "signature": null,
    "title": null,
    "desc": null,
    "corp": {
        "id": "15659",
        "name": "wlj",
        "address": "hangzhou",
        "adminName": "wlj",
        "account": "wlj",
        "phone": "+86********",
        "country": "chinaPR",
        "email": "********@huawei.com",
        "enableSMS": true,
        "enablePstn": false,
        "autoUserCreate": true
    },
    "function": {
        "enableRoom": false
    },
    "status": 0,
    "sortLevel": 10000,
    "hidePhone": false
}

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 na Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Access-Token: stbLRonxHFt7jfbMHSY2UufNZewbPwb8TP8y' https://api.meeting.huaweicloud.com/v1/usg/dcs/member
Tópico principal: APIs