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 administrador empresarial/ APIs/ Consulta de un administrador de empresa

Actualización más reciente 2023-01-31 GMT+08:00

Ver PDF

Consulta de un administrador de empresa

Descripción

Esta API se utiliza para consultar a un administrador de empresa.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retardo de solicitud TP99: 102 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/corp/admin/{account}
Protocolo de transporte	HTTPS

Parámetros de solicitud

**Tabla 2** Parámetros
Parámetro	Obligatorio	Tipo	Localización	Descripción
account	Sí	String	Path	Cuentas de usuario. Si se utiliza el modo de autenticación de cuenta y contraseña, el valor es una cuenta de Huawei Cloud Meeting. Si se utiliza el modo de autenticación de ID de aplicación, el valor es un ID de usuario de terceros.
accountType	No	Integer	Query	Tipo de cuenta. 0: Cuenta de la reunión en Huawei Cloud, que se utiliza para la autenticación de cuentas y contraseñas. 1: ID de usuario de terceros, que se utiliza para la autenticación de ID de aplicación. Valor predeterminado: 0.
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

**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
account	String	Cuenta de usuario.
adminType	Integer	Tipo de administrador. 0: administrador predeterminado. 1: administrador común.
country	String	País o región a la que pertenece el número de móvil.
dept	DeptBasicDTO object	Información básica del departamento. La información del departamento debe mostrarse cuando se consulta a un administrador de empresa.
email	String	Dirección de correo.
id	String	ID de usuario.
name	String	Nombre del administrador.
phone	String	Número de móvil.

**Tabla 5** DeptBasicDTO parameters
Parámetro	Tipo	Descripción
corpId	String	ID de la empresa.
deptCode	String	Código de departamento.
deptName	String	Nombre del departamento.
deptNamePath	String	Ruta del nombre del departamento.
parentDeptCode	String	Código del departamento principal.

Ejemplo de solicitud

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)

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: 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 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: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/admin/test006?accountType=0

Tema principal: APIs

Tema anterior: Adición de un administrador de empresa

Tema siguiente: Supresión de Administradores de Empresa en Lotes