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 administradores de empresa en páginas
Actualización más reciente 2023-01-31 GMT+08:00
Ver PDF
Compartir

Consulta de administradores de empresa en páginas

Descripción

Esta API se utiliza para consultar a los administradores de empresa en las páginas.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retraso de la petición TP99: 445 ms

Depuración

Puedes depurar esta API en Explorador de API.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Direccion de solicitud

/v1/usg/dcs/corp/admin

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

offset

No

Integer

Query

Desplazamiento de consulta. Si el valor excede el número máximo de registros disponibles, se devuelven los registros de la última página.

limit

No

Integer

Query

Número de registros a consultar.

Valor predeterminado: 10.

searchKey

No

String

Query

Criterios de búsqueda. Se admite la búsqueda difusa por nombre, número de teléfono móvil, dirección de correo electrónico, cuenta y cuenta de terceros.

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 el chino (predeterminado) y en-US para el 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 no vá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

count

Integer

Número total de registros.

limit

Integer

Número de registros mostrados por página.

Valor predeterminado: 10.

offset

Integer

Número de la página de inicio de la consulta. El valor comienza desde 0.

data

Array of QueryAdminResultDTO objects

Detalles devueltos acerca de los administradores de empresa.
Tabla 5 Parámetros de QueryAdminResultDTO

Parámetro

Tipo

Descripción

account

String

Cuenta de administrador.

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

Detalles básicos del departamento.

email

String

Dirección de correo electrónico.

id

String

ID de usuario.

name

String

Nombre del administrador.

phone

String

Número móvil.
Tabla 6 Parámetros de DeptBasicDTO

Parámetro

Tipo

Descripción

corpId

String

ID de 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.

Solicitud de ejemplo

GET /v1/usg/dcs/corp/admin
Connection: keep-alive
X-Access-Token: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U
content-type: application/json
Content-Length: 40
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

{
    "offset": 0,
    "limit": 10,
    "count": 1,
    "data": [
        {
            "id": "ff8080816a024f05016a4e1c2c570a5d",
            "account": "test006",
            "name": "test006",
            "adminType": 1,
            "email": "menmeng1@huawei.com",
            "phone": null,
            "country": null,
            "dept": 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 en el Centro 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
Tema principal: APIs