QwenCloudBRASIL
Início›Biblioteca›Documentação
Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Obtenha credenciais de autenticação

Obtenha as credenciais de autenticação exigidas pelo HappyOyster servidor e cliente: Host de API, chave de API primária, chave de API temporária e ticket.

Para o geral HappyOyster arquitetura, consulte a Visão geral.

Credenciais de autenticação

Todas as APIs são autenticadas através do Alibaba Cloud QwenCloud portal. Três credenciais estão envolvidas:

<table><colgroup><col style={{ width: "19.02%" }} /><col style={{ width: "19.26%" }} /><col style={{ width: "40.25%" }} /><col style={{ width: "21.47%" }} /></colgroup><thead><tr><th> Credencial </th><th> Usado por </th><th> Objetivo </th><th> Validade </th></tr></thead><tbody><tr><td> Chave de API primária </td><td> Somente servidor </td><td> Chama todas as APIs abertas (gerenciar mundos, trocar por tickets, gerar chaves de API temporárias, consultar artefatos) </td><td> Longa vida </td></tr><tr><td> Chave de API temporária (também chamado <code>ficha</code> no SDK) </td><td> SDK do cliente </td><td> Autenticação da camada HTTP para o SDK (injetada via <code>atualizarToken</code>); simplesmente busque e injete novamente após a expiração </td><td> Padrão 1 minuto, até 30 minutos (configurado via <code>expirar_em_segundos</code>); deve ser renovado </td></tr><tr><td> bilhete </td><td> SDK do cliente </td><td> Credencial de uso único para entrada na sala; trocado no servidor e entregue ao cliente </td><td> 30 minutos, uso único </td></tr></tbody></table>

Fluxo de credenciais:

Obtenha credenciais de autenticação

A chave de API primária é obtida no QwenCloud console; o host da API é fixado em https://maas.qwencloudapi.com. A chave de API temporária e ticket são emitidos pelo seu servidor por meio das APIs correspondentes e entregues ao cliente.

Somente durante o teste de integração local você poderá injetar temporariamente a chave de API primária no SDK para percorrer o fluxo. Depois de distribuir externamente ou integrar com o cliente de outra parte, você deverá mudar para a chave de API temporária. Nunca entregue a chave de API primária a um cliente ou agrupe-a em um aplicativo para distribuição.

1. Confirme o host da API

O HappyOyster Open API e cliente SDK API Host é https://maas.qwencloudapi.com; nenhuma pesquisa no console é necessária. Configure o SDK do servidor e do cliente com este host.

2. Obtenha a chave primária da API

Consulte Obter e configurar uma chave de API. A chave API primária deve ser armazenada apenas no seu servidor; não o entregue ao cliente nem o agrupe em um aplicativo para distribuição.

3. Obtenha a chave de API temporária

No servidor, use a chave de API primária para chamar o endpoint Gerar chave de API temporária (POST https://maas.qwencloudapi.com/api/v1/tokens; a chave temporária começa com st-, herda as permissões da chave primária, TTL 1–1800s), depois entrega a chave de API temporária retornada ao SDK do cliente e injeta-a via updateToken. Quando expirar, gere um novo e injete novamente — não há necessidade de trocar novamente o ticket.

4. Obtenha o ingresso

No servidor, use a chave de API primária para chamar o endpoint Get Travel Credential que corresponde ao modo do seu mundo, obtenha a entrada de quarto de uso único tickete entregá-lo ao cliente:

Cada ticket está vinculado individualmente a uma Viagem e pode ser usado uma vez em 30 minutos; cada nova viagem requer um novo bilhete.

Próximas etapas