Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Meeting/ Referência de API do servidor/ Autenticação de logon/ APIs/ Atualização de um token
Atualizado em 2023-08-02 GMT+08:00
Ver PDF
Compartilhar

Atualização de um token

Descrição

Essa API é usada para atualizar o período de validade de um token.

SLA

Taxa de sucesso de solicitação: > 99,99%

Atraso na solicitação TP99: 97 ms

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

PUT

Endereço de solicitação

/v1/usg/acs/token

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

X-Access-Token

Sim

String

Cabeçalho

Autenticação de token.

X-Request-ID

Não

String

Cabeçalho

ID da solicitação, que é usado para rastreamento e localização de falhas. É aconselhável usar um UUID. Se este parâmetro não for transportado, um ID de solicitação é gerado automaticamente.

Accept-Language

Não

String

Cabeçalho

Idioma. Valores: zh-CN para chinês (padrão) e en-US para inglês.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é executada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

accessToken

String

Token de acesso.

clientType

Integer

Tipo da conta usada para fazer logon.

  • 72: chamada de API.

createTime

Long

Carimbo de data/hora quando o token é criado, em milissegundos.

daysPwdAvailable

Integer

Período de validade de senha.

delayDelete

Boolean

Se a exclusão do token está atrasada.

expireTime

Long

Carimbo de data/hora quando o token expira, em segundos.

firstLogin

Boolean

Se o logon é o primeiro logon.

NOTA:

Se você fizer logon no sistema pela primeira vez, o sistema solicitará que você altere a senha inicial.

Valor padrão: false.

forceLoginInd

Integer

Se o logon preventivo está ativado.

  • 0: desativado.
  • 1: ativado. (Este valor não é fornecido.)

proxyToken

ProxyTokenDTO object

Informações de autenticação do proxy.

pwdExpired

Boolean

Se a senha expirou.

Valor padrão: false.

refreshCreateTime

Long

Carimbo de data/hora quando um token de atualização é criado, em milissegundos.

refreshExpireTime

Long

Carimbo de data/hora quando o token de atualização expira, em segundos.

refreshToken

String

Token de atualização.

refreshValidPeriod

Long

Período de validade do token de atualização, em segundos.

tokenIp

String

Endereço IP do usuário.

tokenType

Inteiro

Tipo de token.

  • 0: token de acesso do usuário.
  • 1: token de controle de reunião.
  • 2: token único.

user

UserInfo object

Detalhes de autenticação do usuário.

validPeriod

Long

Período de validade do token, em segundos.

Exemplo de solicitação

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)

Exemplo de resposta

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 erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo 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'
Tópico principal: APIs