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/ Verificação de um token

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Verificação de um token

Descrição

Esta API é usada para verificar a validade de um token. Depois de receber a solicitação, o servidor verifica a validade do token e retorna o resultado. Se needGenNewToken for definido como true, um novo token será gerado e retornado.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

**Tabela 1** Protótipo
Método de solicitação	POST
Endereço de solicitação	/v1/usg/acs/token/validate
Protocolo de transporte	HTTPS

Parâmetros de solicitação

**Tabela 2** Parâmetros
Parâmetro	Obrigatório	Tipo	Localização	Descrição
Content-Type	Sim	String	Cabeçalho	Formato de mídia do corpo, por exemplo, application/json; charset=UTF-8.
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.
token	Sim	String	Corpo	Token da conta de logon, uma cadeia.
needGenNewToken	Sim	Boolean	Corpo	Se gerar um novo token. true: um novo token é gerado. false: nenhum novo token é gerado.
needAccountInfo	Não	Boolean	Corpo	Se deve retornar os detalhes da conta do usuário (como a conta e o nome).

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	Integer	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

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"
}

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: 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 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 -X POST  -H 'Content-Type:application/json' -d '{"needGenNewToken":false,"needAccountInfo":true,"token":"stbNYluHvordsmyF2Ubt271qDr6WDAVLtLRb"}' 
'https://api.meeting.huaweicloud.com/v1/usg/acs/token/validate'

Tópico principal: APIs

Tópico anterior: Atualização de um token

Próximo tópico: Término da sessão