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 departamento/ APIs/ Consulta de um departamento e seus subdepartamentos de nível 1
Atualizado em 2023-08-02 GMT+08:00

Consulta de um departamento e seus subdepartamentos de nível 1

Descrição

Esta API é usada por um administrador empresarial para consultar um departamento e seus subdepartamentos de nível 1.

SLA

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

Atraso na solicitação TP99: 156 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/dept/{dept_code}

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

deptCode

Sim

String

Caminho

Código do departamento. O código do departamento de raiz é 1.

O valor pode conter até 32 caracteres.

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

childDepts

Array of QueryDeptResultDTO objects

Lista de subdepartamentos.

corpId

String

ID empresarial.

deptCode

String

Código do departamento.

deptCodePath

String

Caminho do código do departamento.

deptLevel

Integer

Nível de departamento.

deptName

String

Nome do departamento.

deptNamePath

String

Caminho do nome do departamento.

designatedOutDeptCodes

Array of IdMarkDTO objects

Lista de departamentos que têm permissão para acessar este departamento.

inPermission

String

Permissões de usuários em outros departamentos para acessar detalhes de usos neste departamento.

isLeafNode

Boolean

Se o departamento tem subdepartamentos.

note

String

Observações.

outPermission

String

Permissões de usuários neste departamento para acessar detalhes de usos em outros departamentos.

parentDeptCode

String

Identificação do departamento pai.

sortLevel

Integer

Número de sequência do departamento.

Tabela 5 QueryDeptResultDTO data structure

Parâmetro

Tipo

Descrição

corpId

String

ID empresarial.

deptCode

String

Código de departamento, que é único em uma empresa.

deptCodePath

String

Caminho do código do departamento.

deptLevel

Integer

Nível de departamento.

deptName

String

Nome do departamento.

deptNamePath

String

Caminho do nome do departamento.

designatedOutDeptCodes

Array of IdMarkDTO objects

Lista de departamentos que têm permissão para acessar este departamento.

inPermission

String

Permissões de usuários em outros departamentos para acessar detalhes de usos neste departamento.

isLeafNode

Boolean

Se o departamento tem subdepartamentos.

note

String

Observações.

outPermission

String

Permissões de usuários neste departamento para acessar detalhes de usos em outros departamentos.

parentDeptCode

String

Identificação do departamento pai.

sortLevel

Integer

Número de sequência do departamento.

Tabela 6 Estrutura de dados IdMarkDTO

Parâmetro

Tipo

Descrição

id

String

Código do departamento.

mark

String

Descrição da saída do comando correspondente ao ID, que geralmente é o nome.

Exemplo de solicitação

GET /v1/usg/dcs/member/dept/1
Connection: keep-alive
X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki
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: 539e8b710378987ffc5eb844b5e5c290

{
    "corpId": "15659",
    "deptCode": "1",
    "deptLevel": 1,
    "deptName": "wangyue",
    "deptNamePath": "wangyue",
    "isLeafNode": false,
    "parentDeptCode": null,
    "deptCodePath": "1",
    "note": null,
    "inPermission": "UNLIMITED",
    "outPermission": "UNLIMITED",
    "designatedOutDeptCodes": [],
    "sortLevel": 1000,
    "childDepts": [
        {
            "deptCode": "U5b",
            "deptLevel": 2,
            "deptName": "openTest001",
            "deptNamePath": "wangyue#openTest001",
            "isLeafNode": true,
            "parentDeptCode": "1",
            "deptCodePath": "1#U5b",
            "note": null,
            "corpId": "15659",
            "inPermission": "UNLIMITED",
            "outPermission": "UNLIMITED",
            "sortLevel": 10000,
            "designatedOutDeptCodes": []
        }
    ]
}

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: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' https://api.meeting.huaweicloud.com/v1/usg/dcs/member/dept/1