跳转到主要内容
Adventure

HappyOyster-Adventure-获取体验凭证 API参考

三方服务端使用主 API Key 换取短时效、一次性的 ticket,再将其安全下发给客户端。此接口只校验 World 归属、状态与规格,不创建 Travel。

POST
/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/get-travel-credential
cURL - 获取体验凭证
curl --location 'https://maas.qianwenaiapi.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/worlds/get-travel-credential' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "encryptedWorldId": "{encryptedWorldId}"
}'
{
  "code": 0,
  "message": null,
  "data": {
    "ticket": "tk_a1b2****",
    "expiresIn": 1800,
    "encryptedWorldId": "enc_a1b2****"
  }
}

适用范围

三方服务端使用主 API Key 换取短时效、一次性的 ticket,再将其安全下发给客户端。调用前请确认:
  • 仅支持主 API Key调用,临时 API Key 不可用(错误码 403003)。
  • World 必须属于当前千问AI平台账号和 Adventure 模型,且状态为 ready。可通过查询World构建状态接口确认。
  • 调用本接口不会创建 Travel;Travel 在客户端进入房间成功时创建。
调用失败时,请参见HappyOyster 错误码。

鉴权

string
header
必填

千问AI平台 API Key。仅支持主 API Key(sk- 开头)。详见获取 API Key。

Header 参数

string
默认值"application/json"
必填

请求内容类型。此参数必须设置为 application/json。

string
必填

API Key 鉴权。仅支持主 API Key,以 sk- 开头,如 sk-xxx。通常配置为环境变量 $DASHSCOPE_API_KEY。临时 API Key(st- 开头)调用返回 403003。

请求体

application/json
string
必填

当前千问AI平台账号名下、状态为 ready 的 Adventure World ID。由创建World接口返回。

响应

200-application/json
integer

返回码。0 表示成功,非 0 为错误码。

string

错误信息。成功时为 null。

object

响应数据。失败时为 null。