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 de usuário

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Consulta de detalhes de usuário

Descrição

Essa API é usada por um administrador empresarial para consultar detalhes sobre um usuário empresarial.

SLA

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

Atraso na solicitação TP99: 39 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/corp/member/{account}
Protocolo de transporte	HTTPS

Parâmetros de solicitação

**Tabela 2** Parâmetros
Parâmetro	Obrigatório	Tipo	Localização	Descrição
account	Sim	String	Caminho	Conta de usuário. Se o modo de autenticação de conta e senha for usado, o valor é uma conta do Huawei Cloud Meeting. Se o modo de autenticação de ID da aplicação for usado, o valor será um ID de usuário de terceiros.
accountType	Não	Integer	Consulta	Tipo de conta. 0: conta do Huawei Cloud Meeting, que é usada para autenticação de conta e senha. 1: ID de usuário de terceiros, que é usado para autenticação de ID de aplicação. Valor padrão: 0.
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	Status 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.

Exemplo de solicitação

GET /v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0
Connection: keep-alive
X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9
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: 646
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 551aeb8cafbbaa7bbbdc7b1c76bba8ac

{
    "activeTime": 1601221696783,
    "adminType": 2,
    "corp": null,
    "country": "chinaPR",
    "deptCode": "1",
    "deptName": "Root Department",
    "deptNamePath": "Root Department",
    "desc": "modDesc",
    "devType": {
        "deviceSize": null,
        "model": null,
        "purchaseChannel": null
    },
    "email": "modEmail@huawei.com",
    "englishName": "modEnglishName",
    "function": {
        "enableRoom": true
    },
    "hidePhone": true,
    "id": "f521bebcbb27422cb3241c4cb19942c5",
    "license": 0,
    "name": "modName",
    "phone": "+86123456789",
    "signature": "modSignature",
    "sipNum": "+8657198480",
    "sortLevel": 1,
    "status": 1,
    "thirdAccount": "thirdAccount",
    "title": "modTitle",
    "userAccount": "3e48b79b660e403cb5e0208f7be83961",
    "userType": 2,
    "visionAccount": null,
    "vmrList": [
        {
            "id": "2c908bc76f61a5f2016f61bbfdf5039b",
            "status": "0",
            "vmrId": "912992631",
            "vmrName": "name's cloud meeting room",
            "vmrPkgId": null,
            "vmrPkgLength": null,
            "vmrPkgName": null,
            "vmrPkgParties": null
        }
    ]
}

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: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member/3e48b79b660e403cb5e0208f7be83961?accountType=0

Tópico principal: APIs

Tópico anterior: Modificação de um usuário

Próximo tópico: Exclusão de usuários em lote