Consulta de información de departamento por código de departamento
Descripción
Esta API se utiliza para consultar información de departamento por código de departamento.
Depuración
Puede depurar esta API en API Explorer.
Prototipo
Método de solicitud |
GET |
---|---|
Dirección de solicitud |
/v1/usg/abs/departments/{dept_code} |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
dept_code |
Sí |
String |
Path |
Código de departamento. El valor puede contener de 1 a 128 caracteres. |
X-Access-Token |
Sí |
String |
Header |
Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación. |
X-Request-Id |
No |
String |
Header |
ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud. |
Accept-Language |
No |
String |
Header |
Idioma. Valores: zh-CN para chino (predeterminado) y en-US para inglés. |
Códigos de estado
Código de estado de HTTP |
Descripción |
---|---|
200 |
Operación exitosa. |
400 |
Parámetros inválidos. |
401 |
La autenticación no se realiza o falla. |
403 |
Permisos insuficientes. |
500 |
Excepción del servidor. |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
deptCode |
String |
Código de departamento. |
deptName |
String |
Nombre del departamento. |
isLeafNodes |
Boolean |
Si el departamento es un nodo hoja, es decir, el departamento no tiene subdepartamentos. |
childDepts |
Array of ChildDeptDTO objects |
Detalles del subdepartamento. |
Ejemplo de solicitud
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)
Ejemplo de respuesta
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 error
Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en Centro de errores de la API de Huawei Cloud.
Ejemplo de comando cURL
curl -k -i -X GET -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' https://api.meeting.huaweicloud.com/v1/usg/abs/departments/1