接口文档
zhengxiaoyu editou esta página 6 anos atrás

接口基本信息

接口地址

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"
}