开放接口
本文档仅限会编程的用户在基于商城部分功能上进行二次开发使用普通用户不需要懂看
当前外部 API 使用的是 管理员 STEAMID + 管理员密码 调用。
也就是请求里带上 sid 和 pass,商城会按管理员身份校验,通过后才允许继续执行。
注意
这些接口建议只给自己可信的程序使用,不要把管理员密码随便放到公开网页、群文件或别人能看到的地方。
外部发货接口
这个接口用于把游戏命令写入商城发货队列。
简单说就是:你把命令转成 codebase64 后提交给商城,商城解码后加入 RCON 发货队列。
- 请求路径
txt
http://商城域名/api/external/delivery- 请求方法
txt
GET 或 POST| 参数 | 是否必填 | 示范数据 | 备注 |
|---|---|---|---|
| sid | 必填 | 76561199174123456 | 商城管理员的 STEAMID |
| pass | 必填 | dajugame | 商城管理员的密码 |
| codebase64 | 必填 | I1NwYXduVmVoaWNsZSBCUENfTGFpa2EgMQ== | 需要写入发货队列的游戏命令,先转成 base64 后提交 |
- 完整请求链接示例
txt
https://你的商城域名/api/external/delivery?sid=管理员STEAMID&pass=管理员密码&codebase64=xxxx- 示例
txt
https://6616.scum.club/api/external/delivery?sid=76561199174123456&pass=dajugame&codebase64=I1NwYXduVmVoaWNsZSBCUENfTGFpa2EgMQ==查询在线玩家接口
这个接口用于查询当前在线玩家信息。
不传玩家参数时,会返回当前在线玩家列表;传了指定玩家参数时,就只查这个玩家。
- 请求路径
txt
http://商城域名/api/external/online-players- 请求方法
txt
GET 或 POST| 参数 | 是否必填 | 示范数据 | 备注 |
|---|---|---|---|
| sid | 必填 | 76561199174123456 | 商城管理员的 STEAMID |
| pass | 必填 | dajugame | 商城管理员的密码 |
| steamid | 可选 | 76561199174123456 | 指定只查询某一个玩家 |
| steam | 可选 | 76561199174123456 | 和 steamid 一样,用于指定玩家 |
| id | 可选 | 76561199174123456 | 和 steamid 一样,用于指定玩家 |
- 返回内容
会返回玩家昵称、假名、STEAMID、游戏美金、金条、声望、最后在线时间等信息。
- 完整请求链接示例
txt
https://你的商城域名/api/external/online-players?sid=管理员STEAMID&pass=管理员密码- 查询指定玩家示例
txt
https://你的商城域名/api/external/online-players?sid=管理员STEAMID&pass=管理员密码&steamid=玩家STEAMID