获取 HappyOyster 服务端与客户端所需的鉴权凭证：API Host、主 API Key、临时 API Key、ticket。
关于 HappyOyster 的整体架构，请参见概述。
鉴权凭证
所有接口通过阿里云百炼平台网关鉴权，涉及以下三种凭证：
凭证 | 使用方 | 用途 | 有效期 |
|---|---|---|---|
主 API Key | 仅服务端 | 调用所有 Open API（管理世界、换取 ticket、生成临时 API Key、查询产物） | 长期 |
临时 API Key | 客户端 SDK | SDK HTTP 层鉴权（通过 | 默认 1 分钟，最长 30 分钟（通过 |
ticket | 客户端 SDK | 仅用于单次进入房间凭证，由服务端换取后下发给客户端 | 30 分钟，一次性 |
凭证流转关系：
- 主 API Key 仅限服务端持有，客户端永不接触。
- 服务端用主 API Key 生成临时 API Key 和 ticket，下发给客户端。
- 客户端通过
updateToken注入临时 API Key（token）。过期时向您的服务端重新请求并再次注入，无需重新换取ticket。 - ticket 为一次性进房凭证，有效期 30 分钟，使用后即失效。每次开始新的 Travel 需重新换取。
获取鉴权凭证
API Host 与主 API Key 均从百炼控制台获取，临时 API Key 与 ticket 由您的服务端调用接口签发后下发给客户端。
重要主 API Key 仅在服务端使用，客户端 SDK 只使用临时 API Key，切勿将主 API Key 下发到客户端或打包进 App 分发。
说明API Host 与 API Key 必须属同一业务空间，否则返回 AccessDenied。
1. 获取 API Host
在业务空间管理页面，复制 API Host 列的内容。服务端与客户端 SDK 都需配置该 API Host。
2. 获取主 API Key
先获取与配置 API Key，再配置 API Key 到环境变量。主 API Key 仅存储在您的服务端，不得下发到客户端或打包进 App 分发。
3. 获取临时 API Key
服务端使用主 API Key 调用生成临时 API Key接口，将返回的临时 API Key 下发给客户端 SDK，通过 updateToken 注入。过期后重新生成并再次注入即可，无需重新换取 ticket。
4. 获取 ticket
服务端使用主 API Key，根据世界模式调用对应的获取体验凭证接口，取得一次性进房凭证 ticket 后下发给客户端：
- 世界探索（Adventure）：HappyOyster-Adventure-获取体验凭证
- 实时导演（Directing）：HappyOyster-Directing-获取体验凭证
- 角色演绎（Acting）：HappyOyster-Acting-获取体验凭证
ticket 与 Travel 一一绑定，30 分钟内一次性使用；每次开始新的 Travel 需重新换取。
下一步
- 接入流程：服务端准备世界、下发凭证、获取产物；客户端 SDK 完成实时体验。