# lock-step.getGameIdentityInfo
本接口应在服务器端调用,详细说明参见服务端 API。
获取对局玩家位次信息
# 请求地址
GET https://api.weixin.qq.com/wxa/getwxagameidentityinfo?access_token=XXX&access_info=YYY
# 请求参数 - Query
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token / cloudbase_access_token | string | 是 | 微信后台接口调用凭证 | |
| access_info | string | 是 | 填onGameEnd接口返回给开发者的 gameAccessInfo |
# 返回值
# Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误提示信息 |
| data | Object | 房间/对局访问凭证数据 |
errcode 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| -1 | 系统繁忙,此时请开发者稍候再试 | |
| 1 | 数据不存在 |
data 的结构
| 属性 | 类型 | 说明 |
|---|---|---|
| info_list | Array.<Object> | 房间/对局访问凭证 |
info_list 的结构
| 属性 | 类型 | 说明 |
|---|---|---|
| client_id | number | 玩家在房间里的唯一性标识 id,该 id 不同于玩家座位号,一旦分配不能修改 |
| open_id | string | 玩家 OpenId |