接口基本信息
接口地址
http://183.234.61.252:8090/
其他说明
除了获取用户信息接口 第一个user_id 为卓望平台的ID
其他的 user_id 均表示为本平台的用户ID
一、用户接口
1.获取用户信息
- 参数提交方式:GET
- 接口地址:Home/User/Info
- 接口参数:
参数名 |
数据类型 |
是否必须 |
说明 |
user_id |
string |
是 |
卓望平台用户ID |
mt |
string |
是 |
用户令牌 |
{
"code": 0,
"msg": "获取用户信息成功",
"info": {
"user_id": 8,
"name": "测试用户_cmcc000022",
"avatar": "https://picsum.photos/200/200/?image=296",
"win_rate": 0,
"play_next": 1
}
}
2.绑定Socket 客户端ID
- 参数提交方式:POST
- 接口地址:Home/User/Bind
- 接口参数:
参数名 |
数据类型 |
是否必须 |
说明 |
client_id |
string |
是 |
Socket 客户端ID |
{
"info": {
"in_game": 0
},
"code": 0,
"msg": "服务连接成功"
}
3.加入匹配
- 参数提交方式:GET
- 接口地址:Home/User/Join
- 接口参数:无
- 返回示例
{
"code": 0,
"msg": "已加入匹配队列"
}
4.回答问题
- 参数提交方式:POST
- 接口地址:Home/User/Answer
- 接口参数:
参数名 |
数据类型 |
是否必须 |
说明 |
question_id |
int |
是 |
题目ID |
option_id |
int |
是 |
选项ID |
{
"code": 0,
"msg": "回答成功"
}
二、Socket 服务端触发接口
1、初始化 (init)
{
"type": "init",
"client_id": "7f0000010b540000004c"
}
2、玩家加入房间 (player_join)
{
"type": "player_join",
"msg": "玩家加入房间",
"info": {
"user": {
"user_id": "2",
"name": "机器人2号",
"avatar": "images/1ae52eefa98369424ca01987f5a81315.jpg",
"win_rate": 0
},
"players": [
{
"user_id": 2,
"avatar": "images/1ae52eefa98369424ca01987f5a81315.jpg",
"name": "机器人2号",
"win_count": 0,
"lose_count": 0
}
]
}
}
{
"type": "player_join",
"msg": "玩家加入房间",
"info": {
"user": {
"user_id": "1",
"name": "机器人1号",
"avatar": "images/8b69946ed90134a1bfa78155889d64b4.jpg",
"win_rate": 0
},
"players": [
{
"user_id": 1,
"avatar": "images/8b69946ed90134a1bfa78155889d64b4.jpg",
"name": "机器人1号",
"win_count": 0,
"lose_count": 0
},
{
"user_id": 2,
"avatar": "images/1ae52eefa98369424ca01987f5a81315.jpg",
"name": "机器人2号",
"win_count": 0,
"lose_count": 0
}
]
}
}
3、获取题目 (question)
{
"type": "question",
"msg": "获取题目成功",
"info": {
"question": {
"question_id": 291,
"title": "吴哥古迹是哪个国家的?"
},
"options": [
{
"option_id": 1008,
"title": "柬埔寨"
},
{
"option_id": 1009,
"title": "菲利宾"
},
{
"option_id": 1010,
"title": "印度"
}
]
}
}
4、玩家回答问题 (answer)
{
"score": 0,
"user_id": 1,
"type": "answer"
}
5、回合结束结算 (round_end) //待定
{
"score": 0,
"user_id": 1,
"type": "answer"
}
6、游戏结束结算 (game_end) //待定
{
"score": 0,
"user_id": 1,
"type": "answer"
}