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 usuarios/ APIs/ Consulta de datos personales como usuario
Actualización más reciente 2023-01-31 GMT+08:00

Consulta de datos personales como usuario

Descripción

Esta API es utilizada por un usuario de empresa para consultar datos personales.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retardo de solicitud TP99: 133 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

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

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

activeTime

Long

Tiempo de activación (marca de tiempo UTC).

adminType

Integer

Tipo de administrador.

  • 0: administrador predeterminado (super).
  • 1: administrador común.
  • 2: miembro común de la empresa (Este valor es válido solo cuando userType se establece en 2.)

corp

CorpBasicInfoDTO object

Datos de registro de empresa, que se devuelven solo cuando los usuarios consultan los datos personales de sí mismos.

country

String

País o región a la que pertenece el número de móvil del usuario.

deptCode

String

Código de departamento.

deptName

String

Nombre del departamento.

deptNamePath

String

Ruta del nombre del departamento.

desc

String

Observaciones.

devType

QueryDeviceInfoResultDTO object

Tipo del dispositivo asociado.

email

String

Dirección de correo.

englishName

String

Nombre en inglés.

function

UserFunctionDTO object

Indicador de función de usuario.

hidePhone

Boolean

Si se debe ocultar el número de móvil.

id

String

ID de usuario.

license

Integer

Licencia.

  • 0: uso comercial.
  • 1: prueba gratuita.

name

String

Nombre del usuario.

phone

String

Número de móvil.

signature

String

Firma.

sipNum

String

Número de SIP.

sortLevel

Integer

Número de secuencia en el directorio corporativo. Un valor menor indica una posición más alta en el directorio corporativo.

status

Integer

Estado del usuario.

  • 0: normal.
  • 1: deshabilitado.

thirdAccount

String

ID de usuario de terceros.

title

String

Cargo.

userAccount

String

Cuenta de Huawei Cloud Meeting.

userType

Integer

Tipo de usuario.

2: miembro de la empresa.

visionAccount

String

Cuenta de TV inteligente única.

vmrList

Array of UserVmrDTO objects

Lista de salas de reuniones en la nube.

Tabla 5 Estructura de datos de UserVmrDTO

Parámetro

Tipo

Descripción

id

String

ID de sala de reunión en la nube:

NOTA:

Coincide con vmrID en la API para crear una reunión.

vmrId

String

Se corrigió el ID de reunión de la sala de reuniones en la nube.

NOTA:

Coincide con vmrConferenceID en la respuesta de llamar a la API para crear una reunión.

vmrName

String

Nombre de la sala de reuniones en la nube.

vmrMode

Integer

Modo de sala de reuniones en la nube.

  • 0: ID personal de la reunión.
  • 1: sala de reuniones en la nube.
  • 2: webinar.

vmrPkgId

String

ID del paquete de sala de reuniones en la nube. Este parámetro se devuelve solo para las salas de reuniones en la nube.

vmrPkgLength

Integer

Duración de la reunión del paquete de sala de reuniones en la nube. Si el valor es 0, la duración de la reunión es ilimitada. Este parámetro se devuelve solo para las salas de reuniones en la nube.

vmrPkgName

String

Nombre del paquete de sala de reuniones en la nube. Este parámetro se devuelve solo para las salas de reuniones en la nube.

vmrPkgParties

Integer

Número de participantes simultáneos en el paquete de salas de reuniones en la nube. Este parámetro se devuelve solo para las salas de reuniones en la nube.

status

Integer

Estado de la sala de reuniones en la nube.

  • 0: normal.
  • 1: deshabilitado.
  • 2: no asignado.
Tabla 6 Estructura de datos de CorpBasicInfoDTO

Parámetro

Tipo

Descripción

account

String

Cuenta del administrador.

address

String

Dirección de la empresa.

adminName

String

Nombre del administrador.

autoUserCreate

Boolean

Si el registro automático de usuarios está habilitado.

country

String

País o región a la que pertenece el número de móvil del administrador.

email

String

Dirección de correo electrónico del administrador.

enablePstn

Boolean

Si PSTN está habilitado.

enableSMS

Boolean

Si desea enviar notificaciones de reunión por mensaje SMS.

id

String

ID de la empresa.

name

String

Nombre de empresa.

phone

String

Número de celular del administrador.

enableCloudDisk

Boolean

Si Clouddrive está habilitado.

corpType

Integer

Tipo de empresa.

Ejemplo de solicitud

GET /v1/usg/dcs/member
Connection: keep-alive
X-Access-Token: stbLRonxHFt7jfbMHSY2UufNZewbPwb8TP8y
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
Content-Length: 812
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: c94f64967745b0670c299c0688479078
Server: api-gateway
X-Request-Id: de796b739528b6a1f72c283a107bdb02

{
    "id": "ff808081699b56cb0169b81a06ee00d9",
    "userAccount": "user8001@corpnew",
    "name": "test008",
    "englishName": null,
    "phone": null,
    "country": null,
    "email": "user8001@corpnew.com",
    "sipNum": "+991116003840",
    "vmrList": [
        {
            "id": "ff808081699b56cb0169b81a06f400db",
            "vmrId": "913371462",
            "vmrName": "user8001's cloud meeting room",
            "vmrMode": 0,
            "vmrPkgId": null,
            "vmrPkgName": null,
            "vmrPkgParties": null,
            "vmrPkgLength": null,
            "status": 0
        },
        {
            "id": "ff808081699b56cb0169b92b45ab0111",
            "vmrId": "919728047",
            "vmrName": "Cloud meeting room 919728047",
            "vmrMode": 1,
            "vmrPkgId": "ff808081680d5b8601682b3436070030",
            "vmrName": "Dedicated operations cloud meeting room_25",
            "vmrPkgParties": 25,
            "vmrPkgLength": 0,
            "status": 0
        }
    ],
    "deptCode": "1",
    "deptName": "wangyue",
    "deptNamePath": "wangyue",
    "userType": 2,
    "adminType": 2,
    "signature": null,
    "title": null,
    "desc": null,
    "corp": {
        "id": "15659",
        "name": "wlj",
        "address": "hangzhou",
        "adminName": "wlj",
        "account": "wlj",
        "phone": "+86********",
        "country": "chinaPR",
        "email": "********@huawei.com",
        "enableSMS": true,
        "enablePstn": false,
        "autoUserCreate": true
    },
    "function": {
        "enableRoom": false
    },
    "status": 0,
    "sortLevel": 10000,
    "hidePhone": false
}

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: stbLRonxHFt7jfbMHSY2UufNZewbPwb8TP8y' https://api.meeting.huaweicloud.com/v1/usg/dcs/member