Consulta de informações de departamento por código de departamento
Descrição
Esta API é usada para consultar informações de departamento por código de departamento.
Depuração
Você pode depurar essa API no API Explorer.
Protótipo
Método de solicitação |
GET |
---|---|
Endereço de solicitação |
/v1/usg/abs/departments/{dept_code} |
Protocolo de transporte |
HTTPS |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Localização |
Descrição |
---|---|---|---|---|
dept_code |
Sim |
String |
Caminho |
Código do departamento. O valor pode conter de 1 a 128 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
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
deptCode |
String |
Código do departamento. |
deptName |
String |
Nome do departamento. |
isLeafNodes |
Boolean |
Se o departamento é um nó folha, ou seja, o departamento não tem subdepartamentos. |
childDepts |
Array of ChildDeptDTO objects |
Detalhes do subdepartamento. |
Exemplo de solicitação
GET /v1/usg/abs/departments/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 { "deptCode": "1", "deptName": "Root Department", "isLeafNodes": false, "childDepts": [ { "deptCode": "rSD4S", "deptName": "Sub-department 1", "isLeafNodes": true }, { "deptCode": "OFFNk", "deptName": "Sub-department 2", "isLeafNodes": false }, { "deptCode": "ccYgH", "deptName": "Sub-department 3", "isLeafNodes": true } ] }
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: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' https://api.meeting.huaweicloud.com/v1/usg/abs/departments/1