Token 转换

将 Steam refresh token 转换为 access token（短期）。

单个 Token 转换

• URL：POST /api/token
• 配额：1 次
• Content-Type：application/json

请求体

字段	类型	必填	说明
refreshToken	string	是	Steam refresh token

请求示例

curl -X POST https://monsteronly.me/api/token \
  -H "Authorization: Bearer sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"refreshToken":"eyJhb..."}'

成功响应

{
  "success": true,
  "data": {
    "success": true,
    "sessionID": "abc123",
    "cookies": ["sessionid=xxx; ...", "..."],
    "steamID": "76561199000000000",
    "accessToken": "eyJhb...",
    "accountName": "user_login_name",
    "quota": { "used": 121, "remaining": 879 }
  }
}

失败响应

Token 无效（仍计费）：

{
  "success": true,
  "data": {
    "success": false,
    "error": "InvalidPassword",
    "quota": { "used": 121, "remaining": 879 }
  }
}

批量 Token 转换

• URL：POST /api/Tokens（SSE 流式）
• 配额：N 次（按传入 token 数量）
• 响应类型：text/event-stream
• 单次最多：由系统设置决定（默认 500）

请求体

字段	类型	必填	说明
refreshTokens	string | string[]	是	逗号分隔字符串或数组，支持中英文逗号

请求示例

curl -N -X POST https://monsteronly.me/api/Tokens \
  -H "Authorization: Bearer sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"refreshTokens":"token1,token2,token3"}'

SSE 事件示例

data: {"type":"start","total":3}

data: {"type":"progress","index":0,"total":3,"processed":1,"successful":1,"failed":0,"result":{"success":true,"steamID":"7656..."}}

data: {"type":"progress","index":1,"total":3,"processed":2,"successful":2,"failed":0,"result":{"success":true,"steamID":"7656..."}}

data: {"type":"progress","index":2,"total":3,"processed":3,"successful":2,"failed":1,"result":{"success":false,"error":"InvalidPassword"}}

data: {"type":"success","total":3,"successful":2,"failed":1,"quota":{"used":124,"remaining":876}}