对局数据开发文档
开发说明
接口域名
- 正式环境:
http://api.bjd-mc.com:8080
申请方式
请联系官方管理员申请个人开发者密钥。 联系方式：QQ 97960910 后续会考虑开放自助申请功能。
使用须知
严禁使用本接口实现任何不公平的竞争优势，例如开发 overlay 等程序。 本接口的主要目的是查询自己或他人的战绩，而不是大量查询对局内游戏用户数据以获取不公平的优势。 一经发现违规使用，将封禁 TOKEN 且不再授权。
数据格式
返回标准 JSON 格式数据，由开发者自行解析。
错误信息
使用标准的 HTTP 状态码表示具体错误，详情可参考错误代码文档。
玩家数据模块
接口地址: POST /gamelog/user
本接口用于获取用户最近的对局记录。
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问 token |
| Content-Type | application/json | 请求格式 |
参数说明
| 字段名 | 必填 | 类型 | 描述 |
|---|---|---|---|
| username | 是 | String | 玩家昵称 |
| page | 否 | int | 页码，不传时默认为 1 |
返回说明
{
"page": 1, //页码
"pageSize": 10, //每页多少条数据
"playerUuid": "a363f9cf-b8f7-47e5-9751-6a605d82b2aa", //玩家唯一uuid
"data": [{ //玩家的对局记录
"date": "2025-09-07 11:44:30", //结束时间
"type": "BW16", //游戏模式
"win": false, //是否胜利
"matchId": "2f8c9a7e-a578-44d7-b0d6-2a8e3ed441ac" //对局id
}, {
"date": "2025-09-07 11:35:24",
"type": "BW16",
"win": false,
"matchId": "9608d620-e6e1-4a92-87e0-71532e2ff8e4"
}, {
"date": "2025-09-07 11:15:09",
"type": "BW16",
"win": true,
"matchId": "897b9777-4d4e-4abd-84d1-6002152b9d9c"
}, {
"date": "2025-09-07 11:06:02",
"type": "BW16",
"win": true,
"matchId": "e2604cba-4606-4dc8-9187-89cf95debc05"
}, {
"date": "2025-09-07 11:00:31",
"type": "BW16",
"win": false,
"matchId": "6b0ffc56-982c-4da0-8398-6f3e3b945dba"
}, {
"date": "2025-09-07 10:54:51",
"type": "BW16",
"win": true,
"matchId": "8d0d962e-5203-4688-aa33-a31b21c6a1a4"
}, {
"date": "2025-09-07 10:39:32",
"type": "SWRDOUBLE",
"win": false,
"matchId": "3467d7a5-8332-4edd-b1f8-4d1d4f758431"
}, {
"date": "2025-09-07 10:35:36",
"type": "SWRDOUBLE",
"win": false,
"matchId": "aff05e25-e1c4-44fe-8873-d240f56ac247"
}, {
"date": "2025-09-07 10:31:43",
"type": "SWRDOUBLE",
"win": false,
"matchId": "300f8c6b-2432-4645-9cbe-ea1d111924e6"
}, {
"date": "2025-09-07 10:24:18",
"type": "SWRDOUBLE",
"win": false,
"matchId": "ab157091-9b6a-4f39-94f0-5e36dc55b5e8"
}
],
"ttl": 120, //缓存超时时间
"banned": false //玩家是否被封禁
}
对局数据模块
POST /gamelog/match
本接口用于获取用户的最近对局记录
请求头
| 请求头 | 请求内容 | 说明 |
|---|---|---|
| Authorization | Basic secretKey | 访问token |
| Content-Type | application/json | 请求方式 |
参数说明
| 字段名 | 必须 | 类型 | 描述 |
|---|---|---|---|
| match | 是 | String | 对局id |
返回说明
{
"_id": "2f8c9a7e-a578-44d7-b0d6-2a8e3ed441ac", //对局id
"start_time": "2025-09-07 11:19:29", //开始时间
"end_time": "2025-09-07 11:44:30", //结束时间
"map": "生物圈", //地图名
"gamemode": "BW16", //游戏模式
"win": "绿队", //胜利队伍
"ttl": 172800, //缓存超时时间
"teams": { //各队伍详细数据
"红队": [{ //队伍名
"damage": 0.0, //造成伤害
"pick_up": { //资源获取
"IRON_INGOT": 224.0,
"DIAMOND": 3.0,
"GOLD_INGOT": 37.0
},
"death": 4.0, //死亡次数
"break": 42.0, //破坏方块
"interception": 29.6, //承受伤害
"player_name": "秀美的罗睺_1", //玩家名
"place": 29.0, //放置方块
"player_uuid": "594e5940-8300-4265-bcfe-8d76176d210c",//玩家uuid
"final_death": 1.0 //最终死亡
}, {
"damage": 5.800000000000001,
"pick_up": {
"IRON_INGOT": 96.0,
"DIAMOND": 2.0,
"GOLD_INGOT": 14.0
},
"death": 5.0,
"break": 1.0,
"interception": 3.2,
"player_name": "宽慰之卵二姐拔线",
"place": 41.0,
"player_uuid": "f321deb0-d0cf-4030-b620-f81a7d2fca8b",
"kill": 1.0
}, {
"use_item": {
"GOLDEN_APPLE": 1.0
},
"damage": 22.799999999999997,
"pick_up": {
"IRON_INGOT": 251.0,
"DIAMOND": 4.0,
"GOLD_INGOT": 39.0
},
"death": 3.0,
"interception": 53.69999999999999,
"player_name": "代金券qVq_1",
"place": 48.0,
"player_uuid": "5970e901-888e-465a-a08c-484f6ec2cf37",
"final_death": 1.0
}, {
"damage": 16.5,
"pick_up": {
"EMERALD": 1.0,
"IRON_INGOT": 68.0,
"GOLD_INGOT": 13.0
},
"death": 3.0,
"interception": 44.49999999999999,
"player_name": "听风肆意绵绵",
"place": 55.0,
"player_uuid": "f44fa902-a58f-4ba7-a15e-f088f1de50d0",
"kill": 2.0,
"final_death": 1.0
}
],
"蓝队": [{
"damage": 4.1,
"pick_up": {
"EMERALD": 6.0,
"IRON_INGOT": 250.0,
"DIAMOND": 22.0,
"GOLD_INGOT": 38.0
},
"death": 4.0,
"upgrade": {
"Protection": 1.0
},
"break": 12.0,
"interception": 36.800000000000004,
"player_name": "王伯涵6645",
"place": 21.0,
"player_uuid": "49f9f48f-e4a9-4d30-b034-1b5331069f8a"
}, {
"damage": 441.80000000000064,
"death": 5.0,
"upgrade": {
"FastDig": 2.0,
"Sharpness": 2.0,
"Protection": 2.0,
"Defense": 1.0
},
"break": 19.0,
"player_uuid": "a363f9cf-b8f7-47e5-9751-6a605d82b2aa",
"kill": 18.0,
"final_kill": 2.0,
"final_death": 1.0,
"use_item": {
"GOLDEN_APPLE": 26.0,
"ENDER_PEARL": 2.0,
"FIRE_CHARGE": 17.0
},
"pick_up": {
"EMERALD": 19.0,
"IRON_INGOT": 879.0,
"DIAMOND": 50.0,
"GOLD_INGOT": 143.0
},
"bed_destory": 3.0,
"interception": 213.00000000000017,
"player_name": "仁慈的护理讲笑话",
"place": 632.0,
"trap": {
"Trap": 2.0
}
}, {
"use_item": {
"FIRE_CHARGE": 1.0
},
"damage": 3.4,
"pick_up": {
"EMERALD": 4.0,
"IRON_INGOT": 416.0,
"DIAMOND": 1.0,
"GOLD_INGOT": 65.0
},
"death": 7.0,
"break": 1.0,
"interception": 63.800000000000004,
"player_name": " 詹博驿",
"place": 59.0,
"player_uuid": "b6f76a48-4eaa-436c-a8c6-c68d4908ff76",
"final_death": 1.0
}, {
"pick_up": {
"IRON_INGOT": 152.0,
"DIAMOND": 4.0,
"GOLD_INGOT": 24.0
},
"death": 2.0,
"break": 1.0,
"player_name": "震怒之巨魔迫降",
"place": 16.0,
"player_uuid": "31d37392-7c4a-4bc4-a28a-8f15b95faf76"
}
],
"黄队": [{
"use_item": {
"GOLDEN_APPLE": 11.0,
"ENDER_PEARL": 3.0,
"FIRE_CHARGE": 11.0
},
"damage": 182.6999999999999,
"pick_up": {
"EMERALD": 19.0,
"IRON_INGOT": 1320.0,
"DIAMOND": 53.0,
"GOLD_INGOT": 243.0
},
"death": 10.0,
"upgrade": {
"Sharpness": 2.0,
"Protection": 1.0
},
"interception": 178.30000000000004,
"player_name": "SHyyyy",
"place": 245.0,
"player_uuid": "f32ff218-7981-4352-a8cf-666ee3fbb2f5",
"kill": 6.0,
"final_kill": 2.0,
"final_death": 1.0
}, {
"use_item": {
"FIRE_CHARGE": 5.0
},
"damage": 70.09999999999998,
"pick_up": {
"EMERALD": 5.0,
"IRON_INGOT": 415.0,
"DIAMOND": 6.0,
"GOLD_INGOT": 67.0
},
"death": 1.0,
"break": 22.0,
"interception": 73.1,
"player_name": "炯炯14514",
"place": 21.0,
"player_uuid": "67fee031-2460-40ea-a333-0c138a813068",
"kill": 3.0
}, {
"damage": 149.90000000000006,
"death": 8.0,
"upgrade": {
"Protection": 1.0
},
"break": 5.0,
"player_uuid": "6d9867d3-b34a-4baf-80c8-1de29d2af8fe",
"kill": 7.0,
"final_kill": 1.0,
"final_death": 1.0,
"use_item": {
"GOLDEN_APPLE": 8.0,
"FIRE_CHARGE": 1.0
},
"pick_up": {
"EMERALD": 14.0,
"IRON_INGOT": 593.0,
"DIAMOND": 10.0,
"GOLD_INGOT": 94.0
},
"interception": 104.10000000000005,
"player_name": "殇归mlio",
"place": 311.0
}, {
"use_item": {
"GOLDEN_APPLE": 2.0,
"FIRE_CHARGE": 1.0
},
"damage": 17.6,
"pick_up": {
"EMERALD": 6.0,
"IRON_INGOT": 598.0,
"DIAMOND": 16.0,
"GOLD_INGOT": 97.0
},
"death": 6.0,
"upgrade": {
"Trap": 1.0,
"Protection": 1.0
},
"break": 16.0,
"interception": 65.0,
"player_name": "你我情绪落泪",
"place": 157.0,
"player_uuid": "bba4ffa3-7d18-4378-9e1f-133aae58d026",
"kill": 1.0,
"final_death": 1.0
}
],
"绿队": [{
"use_item": {
"GOLDEN_APPLE": 1.0,
"SNOWBALL": 1.0,
"FIRE_CHARGE": 10.0
},
"damage": 8.9,
"pick_up": {
"IRON_INGOT": 1525.0,
"GOLD_INGOT": 247.0
},
"death": 4.0,
"break": 7.0,
"interception": 65.4,
"player_name": "玄千墨",
"place": 97.0,
"player_uuid": "171c5769-3eb1-448b-bd4c-6917a73f740e",
"kill": 2.0,
"final_kill": 1.0,
"final_death": 1.0
}, {
"use_item": {
"FIRE_CHARGE": 4.0
},
"damage": 125.39999999999998,
"pick_up": {
"EMERALD": 11.0,
"IRON_INGOT": 610.0,
"GOLD_INGOT": 100.0
},
"death": 8.0,
"upgrade": {
"Heal": 1.0
},
"break": 7.0,
"interception": 129.19999999999993,
"player_name": "博学而天阳",
"place": 349.0,
"player_uuid": "7eb5e91f-1fb0-4fff-9d55-bcc94447c785",
"kill": 4.0,
"final_kill": 1.0
}, {
"damage": 136.29999999999998,
"death": 5.0,
"upgrade": {
"Trap": 1.0,
"Protection": 2.0,
"Sharpness": 2.0,
"IronForge": 1.0
},
"break": 47.0,
"player_uuid": "4e140705-17ce-40bf-b45d-525a7e4465be",
"kill": 4.0,
"final_kill": 2.0,
"use_item": {
"OBSIDIAN": 9.0,
"GOLDEN_APPLE": 14.0,
"FIRE_CHARGE": 1.0
},
"pick_up": {
"EMERALD": 30.0,
"IRON_INGOT": 524.0,
"DIAMOND": 50.0,
"GOLD_INGOT": 88.0
},
"bed_destory": 1.0,
"interception": 126.00000000000003,
"player_name": "悲惨程序吃水果",
"place": 199.0,
"trap": {
"Defense": 1.0
}
}
]
}
}