登录 Token 签发 API

业务服务器可使用 API Key 调用该接口，为客户端申请 SDK 登录所需的登录 token。API Key 应保存在业务服务器内，不应下发到客户端。

请求

请求示例

curl https://open.xunlei.com/api/v1/sdk/login_token \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: your-api-key' \
  --data '{
  "expires_in": 1,
  "scopes": [
    "xtask.p2sp",
    "xindex.query"
  ]
}'

请求参数

请求头

Header	类型	说明
Content-Type	string	请求体类型，固定为 application/json。
X-API-Key	string	API key，用于鉴权。

请求体

{
  "expires_in": 1,
  "scopes": ["xtask.p2sp", "xindex.query"]
}

参数	类型	说明
expires_in	integer	Token 有效时长，单位秒；为空时默认 86400。格式为 int32，即 signed 32-bit integer。
scopes	string[]	Token scopes；为空时使用内置默认值

scopes 支持以下枚举值：

枚举值	说明
xtask.p2sp	HTTP 协议 + p2sp 加速下载能力
xindex.query	下载索引查询能力

响应

响应体

{
  "token": "jwt-login-token",
  "expires_in": 86400
}

响应参数

参数	类型	说明
token	string	JWT 登录 Token。
expires_in	integer	Token 有效时长，单位秒。格式为 int32。