Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Gestión de departamentos/ APIs/ Consulta de un departamento y sus subdepartamentos de nivel-1
Actualización más reciente 2023-01-31 GMT+08:00

Consulta de un departamento y sus subdepartamentos de nivel-1

Descripción

Esta API se utiliza por un administrador de empresa para consultar un departamento y sus subdepartamentos de nivel-1.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retardo de solicitud TP99: 156 ms

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Dirección de solicitud

/v1/usg/dcs/member/dept/{dept_code}

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

deptCode

String

Path

Código de departamento. El código del departamento root es 1.

El valor puede incluir hasta 32 caracteres.

X-Access-Token

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

Tabla 3 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

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

childDepts

Array of QueryDeptResultDTO objects

Lista de subdepartamentos.

corpId

String

ID de la empresa.

deptCode

String

Código de departamento.

deptCodePath

String

Ruta del código del departamento.

deptLevel

Integer

Nivel de departamento.

deptName

String

Nombre del departamento.

deptNamePath

String

Ruta del nombre del departamento.

designatedOutDeptCodes

Array of IdMarkDTO objects

Lista de departamentos que pueden acceder a este departamento.

inPermission

String

Permisos de usuarios en otros departamentos para acceder a detalles de usos en este departamento.

isLeafNode

Boolean

Si el departamento tiene subdepartamentos.

note

String

Observaciones.

outPermission

String

Permisos de los usuarios en este departamento para acceder a detalles de usos en otros departamentos.

parentDeptCode

String

ID del departamento principal.

sortLevel

Integer

Número de secuencia del departamento.

Tabla 5 Estructura de datos QueryDeptResultDTO

Parámetro

Tipo

Descripción

corpId

String

ID de la empresa.

deptCode

String

Código de departamento, que es único en una empresa.

deptCodePath

String

Ruta del código del departamento.

deptLevel

Integer

Nivel de departamento.

deptName

String

Nombre del departamento.

deptNamePath

String

Ruta del nombre del departamento.

designatedOutDeptCodes

Array of IdMarkDTO objects

Lista de departamentos que pueden acceder a este departamento.

inPermission

String

Permisos de usuarios en otros departamentos para acceder a detalles de usos en este departamento.

isLeafNode

Boolean

Si el departamento tiene subdepartamentos.

note

String

Observaciones.

outPermission

String

Permisos de los usuarios en este departamento para acceder a detalles de usos en otros departamentos.

parentDeptCode

String

ID del departamento padre.

sortLevel

Integer

Número de secuencia del departamento.

Tabla 6 Estructura de datos IdMarkDTO

Parámetro

Tipo

Descripción

id

String

Código de departamento.

mark

String

Descripción de salida del comando correspondiente al ID, que generalmente es el nombre.

Ejemplo de solicitud

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)

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

{
    "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 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 enCentro 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/dcs/member/dept/1