【API教程】XyeBBS整合包游玩记录上报接口接入教程
论坛事务-其他浏览 595回复 0发布于 2025-06-28 18:08:04
整合包游玩记录上报接口接入教程
介绍
该接口可用于为您的整合包提供云端的玩家游玩数据的记录,您只需要接入该平台。
我们将为你提供全套的适配Mod,模组将会在触发对应条件时,提示玩家对对应整合包进行评分。
同时我们将会记录客户端如下数据:
- 提交IP
- 玩家ID
- 是否正版
- 游玩时间
- 玩家死亡次数
- 击杀怪物数量
- 挖掘方块数量
- 是否完成所有任务
- 评分值
- 评分内容
为防止接口的滥用,我们将会进行一些常规的防机器人手段:
- 必须携带对应的User-Agent,否则请求将会被过滤
- 对应资源同一IP仅能提交一次数据,后续将无法修改
接口详细
请求地址
https://resource-api.xyeidc.com/api/resources/{resourceId}/play/records
请求格式
POST
请求头
"UserAgent": "XyeBBS-GameClient"
请求Body
| 字段 | 类型 | 必须 | 备注 |
|---|---|---|---|
| gameId | string | √ | 玩家ID |
| onlineMode | string | √ | 玩家ID |
| playTime | long | √ | 游玩时间(minute) |
| deathCount | integer | √ | 死亡次数 |
| breakBlockCount | integer | √ | 挖掘方块数量 |
| placeBlockCount | integer | √ | 放置方块数量 |
| killCount | integer | √ | 击杀数量 |
| questFinished | boolean | 是否完成所有任务 | |
| score | float | √ | 分数(0-5) |
| notes | string | 评论内容 |
范例
{
"gameId": "EvoYyc",
"onlineMode": true,
"playTime": 1232,
"deathCount": 23,
"breakBlockCount": 4262,
"placeBlockCount": 4244,
"killCount": 321,
"questFinished": true,
"score": 5,
"notes": "评价内容"
}
返回值
Success - 成功
{
"data": null,
"msg": "Success",
"code": 200
}
Fail - 失败
{
"data": null,
"msg": "失败原因",
"code": 501
}
注意事项
必须携带User-Agent否则请求将被过滤
代码范例(待完成)
XyeAPI.java
// 使用Java语言接入
帖子打赏
参与人数打赏物品(0)
正在加载内容…
回复帖子善语结善缘,恶语伤人心。要记得文明发言哦!
登录后参与讨论登录账号后即可发表您的回复和看法
