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 do administrador empresarial/ APIs/ Consulta de um administrador empresarial
Atualizado em 2023-08-02 GMT+08:00
Ver PDF
Compartilhar

Consulta de um administrador empresarial

Descrição

Esta API é usada para consultar um administrador empresarial.

SLA

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

Atraso na solicitação TP99: 102 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/admin/{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

account

String

Conta de usuário.

adminType

Integer

Tipo de administrador.

  • 0: administrador padrão.
  • 1: administrador comum.

country

String

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

dept

DeptBasicDTO object

Informações básicas do departamento. As informações do departamento devem ser exibidas quando um administrador corporativo é consultado.

email

String

Endereço de e-mail.

id

String

ID do usuário.

name

String

Nome do administrador.

phone

String

Número de celular.
Tabela 5 Parâmetros de DeptBasicDTO

Parâmetro

Tipo

Descrição

corpId

String

ID da empresa.

deptCode

String

Código do departamento.

deptName

String

Nome do departamento.

deptNamePath

String

Caminho do nome do departamento.

parentDeptCode

String

Código do departamento de pais.

Exemplo de solicitação

GET /v1/usg/dcs/corp/admin/test006?accountType=0
Connection: keep-alive
X-Access-Token: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U
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
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: efd3e53b2d9fa554d11267d5d66ca0bf

{
    "id": "ff8080816a024f05016a4e1c2c570a5d",
    "account": "test006",
    "name": "test006",
    "adminType": 1,
    "email": "menmeng1@huawei.com",
    "phone": null,
    "country": null,
    "dept": {
        "deptCode": "1",
        "corpId": "15659",
        "deptName": "wangyue",
        "deptNamePath": "wangyue",
        "parentDeptCode": 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 no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Access-Token: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/admin/test006?accountType=0
Tópico principal: APIs