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/ Autenticación del inicio de sesión/ APIs/ Verificación de un Token

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

Ver PDF

Verificación de un Token

Descripción

Esta API se utiliza para verificar la validez de un token. Después de recibir la solicitud, el servidor verifica la validez del token y devuelve el resultado. Si needGenNewToken se establece en true, se genera un nuevo token y se devuelve.

Depuración

Puede depurar esta API en Explorador de API.

Prototipo

**Tabla 1** Prototipo
Método de solicitud	POST
Dirección de solicitud	/v1/usg/acs/token/validate
Protocolo de transporte	HTTPS

Parámetros de solicitud

**Tabla 2** Parámetros
Parámetro	Obligatorio	Tipo	Localización	Descripción
Content-Type	Sí	String	Header	Formato de medios del cuerpo, por ejemplo, application/json; charset=UTF-8.
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.
token	Sí	String	Body	Token de la cuenta de inicio de sesión, una cadena.
needGenNewToken	Sí	Boolean	Body	Ya sea para generar un nuevo token. true: Se genera un nuevo token. false: No se genera ningún token nuevo.
needAccountInfo	No	Boolean	Body	Si desea devolver los detalles de la cuenta del usuario (como la cuenta y el nombre).

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
accessToken	String	Token de acceso.
clientType	Integer	Tipo de cuenta utilizada para iniciar sesión. 72: llamada a la API.
createTime	Long	Marca de tiempo cuando se crea el token, en milisegundos.
daysPwdAvailable	Integer	Período de validez de la contraseña.
delayDelete	Boolean	Si se retrasa la eliminación del token.
expireTime	Long	Marca de tiempo cuando el token caduca, en segundos.
firstLogin	Boolean	Si el inicio de sesión es el primer inicio de sesión. NOTA: Si inicia sesión en el sistema por primera vez, el sistema le pedirá que cambie la contraseña inicial. Valor predeterminado: false.
forceLoginInd	Integer	Si el inicio de sesión apropiativo está habilitado. 0: Deshabilitado. 1: Habilitado. (Este valor no se proporciona.)
proxyToken	ProxyTokenDTO object	Información de autenticación de proxy.
pwdExpired	Boolean	Si la contraseña ha caducado. Valor predeterminado: false.
refreshCreateTime	Long	Marca de tiempo cuando se crea un token de actualización, en milisegundos.
refreshExpireTime	Long	Marca de tiempo cuando el token de actualización expira, en segundos.
refreshToken	String	Actualice el token.
refreshValidPeriod	Long	Período de validez del token de actualización, en segundos.
tokenIp	String	Dirección IP del usuario.
tokenType	Integer	Tipo de token. 0: token de acceso de usuario. 1: token de control de reunión. 2: one-off token.
user	UserInfo object	Detalles de autenticación de usuario.
validPeriod	Long	Período de validez del token, en segundos.

Solicitud de ejemplo

POST /v1/usg/acs/token/validate
Connection: keep-alive
Content-Type: application/json
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "needGenNewToken": false,
    "needAccountInfo": true,
    "token": "stbNYluHvordsmyF2Ubt271qDr6WDAVLtLRb"
}

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: 143
Connection: keep-alive
X-Request-Id: f90fbd8714328398fcbedddde0f1303c

{
    "accessToken": "stbNYluHvordsmyF2Ubt271qDr6WDAVLtLRb",
    "tokenIp": "10.8.0.130",
    "validPeriod": null,
    "expireTime": 1582901905,
    "createTime": null,
    "user": {
        "userId": "zhangsan@cloudlinkwp",
        "ucloginAccount": "zhangsan@cloudlinkwp",
        "serviceAccount": "sip:878587543144724349434080@huaweicloud.com",
        "numberHA1": "1ead5e5ce44849bc2718d5cb479c890f",
        "alias1": null,
        "companyId": "12345",
        "spId": "3be969ebb05a4723a234d534bcf36680",
        "companyDomain": null,
        "realm": "huawei.com",
        "userType": 2,
        "adminType": 2,
        "name": "zhangsan",
        "nameEn": null,
        "isBindPhone": null,
        "freeUser": false,
        "thirdAccount": "zhangsan@cloudlinkwp",
        "visionAccount": null,
        "headPictureUrl": null
    },
    "clientType": 72,
    "forceLoginInd": null,
    "firstLogin": false,
    "pwdExpired": false,
    "daysPwdAvailable": 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 POST  -H 'Content-Type:application/json' -d '{"needGenNewToken":false,"needAccountInfo":true,"token":"stbNYluHvordsmyF2Ubt271qDr6WDAVLtLRb"}' 
'https://api.meeting.huaweicloud.com/v1/usg/acs/token/validate'

Tema principal: APIs

Tema anterior: Actualización de un token

Tema siguiente: Cierre de sesión