账号信息查询
查询 Steam 账号的各项信息,支持多字段组合。
单个账号查询
- URL:
POST /api/account - 配额:1 次(不论 fields 选多少)
- Content-Type:
application/json
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| refreshToken | string | 是 | Steam refresh token |
| fields | string | 是 | 要查询的字段,逗号分隔,支持中文别名 |
fields 可选值
| 英文 | 中文别名 | 说明 |
|---|---|---|
| userinfo | 个人信息 | 昵称、余额、国家、Steam ID |
| ban | 封禁 | VAC / 游戏封禁状态及到期时间 |
| communityban | 红信 | 社区禁言状态 |
| online | 在线 | 在线状态 |
| perfectworld | 国服 | 是否绑定国服(Perfect World) |
| experience | 等级 | CS2 账号等级和经验值 |
| premier | 段位 | CS2 Premier 段位 |
| inventory | 库存 / cs2库存 | CS2 饰品库存 + 价格 |
| games | 游戏库 | Steam 游戏列表(含游戏时长、中文名) |
请求示例
bash
curl -X POST https://monsteronly.me/api/account \
-H "Authorization: Bearer sk_xxxx" \
-H "Content-Type: application/json" \
-d '{
"refreshToken": "eyJhb...",
"fields": "个人信息,封禁,红信,在线,国服,等级,段位,库存,游戏库"
}'响应示例(请求了全部字段)
json
{
"success": true,
"data": {
"success": true,
"steamID": "76561199000000000",
"personaName": "玩家昵称",
"balance": "¥ 100.00",
"country": "CN",
"steam64Id": "76561199000000000",
"steam17Id": "12345678",
"banStatus": "无封禁",
"banType": "none",
"communityBan": "无红信",
"onlineStatus": "online",
"perfectWorld": "无",
"rank": 18,
"experiencePoints": 1250,
"lastLoginTime": "Oct 10, 2025 @ 14:23",
"cs2Data": {
"success": true,
"premierRating": 12500,
"premierWins": 42,
"competitiveRank": 15,
"competitiveRankName": "Distinguished Master Guardian",
"wingmanRank": null,
"wingmanWins": null,
"commendFriendly": 30,
"commendTeaching": 12,
"commendLeader": 8
},
"inventoryTotalCount": 79,
"inventoryItems": [
{
"assetId": "123456789",
"name": "AK-47 | Redline (Field-Tested)",
"type": "Classified Rifle",
"tradable": true,
"marketable": true,
"iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/xxxxx",
"price": 85.50
}
],
"totalGames": 128,
"totalPlaytimeHours": 523.45,
"recentPlaytimeHours": 12.3,
"games": [
{
"appid": 730,
"name": "反恐精英 2",
"playtime_forever": 18250,
"playtime_2weeks": 420,
"img_icon_url": "69f7ebe2735c366c65c0b33dae00e12dc40edbe4"
}
],
"quota": { "used": 122, "remaining": 878 }
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| success | boolean | 查询是否成功 |
| steamID | string | Steam 64 位 ID |
| personaName | string | 玩家昵称 |
| balance | string | 钱包余额(带货币符号) |
| country | string | 国家代码(如 CN、US) |
| banStatus | string | 封禁状态文本:无封禁 / 永久VAC / 到期时间字符串 |
| banType | string | none / permanent / temporary |
| communityBan | string | 无红信 / 社区红信 |
| onlineStatus | string | online / offline |
| perfectWorld | string | 有 / 无 / 未知 |
| rank | number | CS2 个人资料等级 |
| experiencePoints | number | 升级所需经验 |
| lastLoginTime | string | 上次 CS:GO/CS2 会话时间(英文) |
| cs2Data | object | CS2 GC 数据(仅 premier 时返回) |
| inventoryTotalCount | number | CS2 饰品库存总数(仅 inventory 时返回) |
| inventoryItems | array | CS2 饰品列表(仅 inventory 时返回) |
| totalGames | number | 拥有的游戏总数(仅 games 时返回) |
| totalPlaytimeHours | number | 总游戏时长小时(仅 games 时返回) |
| recentPlaytimeHours | number | 最近两周游戏时长小时(仅 games 时返回) |
| games | array | 游戏列表(仅 games 时返回) |
各字段独立容错:单个字段查询失败时,响应里会出现对应的 xxxError 字段(如 userinfoError、banError、inventoryError、gamesError),不影响其它字段正常返回。
失败响应
json
{
"success": false,
"message": "Token 无效或已过期"
}批量账号查询
- URL:
POST /api/accounts(SSE 流式) - 配额:N 次(按 token 数量,不论 fields 选多少)
- 响应类型:
text/event-stream - 单次最多:由系统设置决定(默认 500)
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| refreshTokens | string | string[] | 是 | 逗号分隔字符串或数组 |
| fields | string | 是 | 同 /api/account |
请求示例
bash
curl -N -X POST https://monsteronly.me/api/accounts \
-H "Authorization: Bearer sk_xxxx" \
-H "Content-Type: application/json" \
-d '{
"refreshTokens": "token1,token2,token3",
"fields": "个人信息,封禁"
}'SSE 响应事件
data: {"type":"start","total":3}
data: {"type":"progress","index":0,"total":3,"processed":1,"successful":1,"failed":0,"result":{"success":true,"steamID":"7656...","personaName":"...","banStatus":"无封禁"}}
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":"Token 无效"}}
data: {"type":"success","total":3,"successful":2,"failed":1,"quota":{"used":128,"remaining":872}}