Steam Token API

Appearance

修改账号资料 ​

修改资料（昵称 / 简介 / 头像） ​

  • URL：POST /api/profiles 或 PATCH /api/profiles（SSE 流式）
  • 配额：
    • 只改昵称和/或简介：N 次
    • 只改头像：N 次
    • 同时改昵称/简介 + 头像：2N 次
  • 批处理：管理端可分别设置修改资料并发数和代理切换阈值；同一代理分组内账号共享代理
  • Content-Type：
    • 只改昵称/简介：application/json
    • 同时改头像：multipart/form-data

请求体 ​

字段类型必填说明
refreshTokensstring | string[]是逗号分隔字符串或数组
personaNamestring否新昵称
summarystring否新简介
avatarfile否新头像

personaName、summary、avatar 至少传一个。

建议

需要同时改昵称/简介/头像时，优先使用这个接口，避免分别调用 /api/profiles 和 /api/profiles/avatar 导致同一批 token 转换两次。

请求示例 ​

只改昵称和简介：

bash
curl -N -X POST https://monsteronly.me/api/profiles \
  -H "Authorization: Bearer sk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "refreshTokens": "token1,token2",
    "personaName": "新昵称",
    "summary": "新的个人简介"
  }'

同时修改昵称、简介、头像：

bash
curl -N -X POST https://monsteronly.me/api/profiles \
  -H "Authorization: Bearer sk_xxxx" \
  -F "refreshTokens=token1,token2" \
  -F "personaName=新昵称" \
  -F "summary=新的个人简介" \
  -F "avatar=@/path/to/image.png"

SSE 响应示例 ​

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

data: {"type":"progress","index":0,"total":2,"processed":1,"successful":1,"failed":0,"steamID":"7656...","changed":["personaName","summary","avatar"]}

data: {"type":"progress","index":1,"total":2,"processed":2,"successful":1,"failed":1,"changed":[],"error":"Session 无效"}

data: {"type":"success","total":2,"successful":1,"failed":1,"quotaPerToken":2,"quota":{"used":134,"remaining":866}}

修改头像（兼容旧接口） ​

  • URL：POST /api/profiles/avatar（SSE 流式）
  • 配额：N 次
  • Content-Type：multipart/form-data
  • 文件限制：
    • 格式：.jpg / .jpeg / .png / .gif / .bmp
    • 大小：最大 1 MB
  • 特殊：单次请求的多个账号，头像是同一张图

表单字段 ​

字段类型必填说明
refreshTokensstring是逗号分隔的 token
avatarfile是图片文件

请求示例 ​

bash
curl -N -X POST https://monsteronly.me/api/profiles/avatar \
  -H "Authorization: Bearer sk_xxxx" \
  -F "refreshTokens=token1,token2" \
  -F "avatar=@/path/to/image.png"

SSE 响应示例 ​

data: {"type":"start","total":2,"message":"文件校验通过，开始批量上传头像"}

data: {"type":"progress","index":0,"total":2,"processed":1,"successful":1,"failed":0,"steamID":"7656...","message":"头像更改成功"}

data: {"type":"progress","index":1,"total":2,"processed":2,"successful":1,"failed":1,"steamID":"7656...","error":"TooManyRequests"}

data: {"type":"success","total":2,"successful":1,"failed":1,"quota":{"used":136,"remaining":864}}