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/ Actualización de un token
Actualización más reciente 2023-01-31 GMT+08:00
Ver PDF

Actualización de un token

Descripción

Esta API se utiliza para actualizar el período de validez de un token.

SLA

Tasa de éxito de solicitudes: > 99.99%

Retardo de solicitud TP99: 97 ms

Depuración

Puede depurar esta API en Explorador de API.

Prototipo

Tabla 1 Prototipo

Método de solicitud

PUT

Dirección de solicitud

/v1/usg/acs/token

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

X-Access-Token

Sí

String

Header

Autenticación de tokens.

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

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

PUT /v1/usg/acs/token
Connection: keep-alive
X-Access-Token: stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ
Content-Type: application/json
Content-Length: 88
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: 714
Connection: keep-alive
X-Request-Id: f90fbd8714328398fcbedddde0f1303c

{
    "accessToken": "stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ",
    "clientType": 72,
    "createTime": 1599102826754,
    "daysPwdAvailable": -18172,
    "delayDelete": false,
    "expireTime": 1577979513,
    "firstLogin": true,
    "forceLoginInd": null,
    "proxyToken": null,
    "pwdExpired": false,
    "refreshCreateTime": 1599102826754,
    "refreshExpireTime": 1601694826,
    "refreshToken": "stbdkkBy2XkfsiPh4cP9xev0oGL5EmiQxP1a",
    "refreshValidPeriod": 2592000,
    "tokenIp": "10.8.0.90",
    "tokenType": 0,
    "user": {
        "adminType": 2,
        "alias1": null,
        "appId": null,
        "cloudUserId": "76aaaba8a12f4c0a8a43192...",
        "companyDomain": null,
        "companyId": "f5968fc4f9c14d50905e8e66672dabc6",
        "corpType": 0,
        "freeUser": false,
        "grayUser": false,
        "headPictureUrl": null,
        "isBindPhone": null,
        "name": "xxxx_name",
        "nameEn": null,
        "numberHA1": "1ead5e5ce44849bc2718d5c....",
        "paidAccount": null,
        "paidPassword": null,
        "password": null,
        "realm": "huaweicloud.com",
        "serviceAccount": "sip:xxxx@huaweicloud.com",
        "spId": "666bd8558e4646e1a7e1a0c99cf898e8",
        "status": 0,
        "thirdAccount": "62fe180o133fd...",
        "tr069Account": "X3M537A6IX4SC...",
        "ucloginAccount": "z8b2vo875ioh54r29ad5e3552vb3gm8np2j167...",
        "userId": "0d5202707123429d876....",
        "userType": 2,
        "visionAccount": null,
        "weLinkUser": false
    },
    "validPeriod": 84616
}

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 Centro de errores de la API de Huawei Cloud.

Ejemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X PUT  -H 'X-Access-Token:stbo3vX1pyduWpSFsjMCmR93mJkfQGnohjvQ' 'https://api.meeting.huaweicloud.com/v1/usg/acs/token'
Tema principal: APIs