Skip to content

game.queryList ​

此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。

查询已上线游戏列表(分页)。对齐 ThirdPartyPlatformGameInfo 核心字段;参考实现见 helloOP GET /developer/game/list。

调用方式:

  • HTTPS 调用

HTTPS 调用 ​

http
POST {query_game_list_webhook}

请求参数 - Header ​

属性类型默认值必填说明
Authorizationstring是格式:Bearer {access_token}

请求参数 - Body ​

属性类型默认值必填说明
page_noint1否页码,从 1 开始
page_sizeint20否每页条数

返回值 ​

Object ​

返回的 JSON 数据包

属性类型说明
ret_codeinteger响应码:0 表示成功,非0 表示失败
ret_msgstring响应描述信息:成功返回 "success",失败返回具体错误原因
dataobject业务数据体(仅 ret_code=0 时返回;无数据时 list 为 [])
data.listarray游戏列表
data.list[].bundle_idstring游戏包名(后续详情/资质/ICP 拉取的唯一键)
data.list[].namestring游戏名称
data.list[].versionstring最新版本号
data.totallong总记录数
data.page_nointeger当前页码
data.page_sizeinteger每页条数
timestamplong毫秒时间戳

ret_code 的合法值 ​

值说明最低版本
0请求成功
40001invalid access_token,访问令牌无效或已过期

cURL 请求 ​

bash
curl -X POST \
  {query_game_list_webhook} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
  "page_no": 1,
  "page_size": 20
}'

成功返回 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "list": [
      {
        "bundle_id": "com.example.game.demo",
        "name": "示例游戏",
        "version": "1.0.0"
      }
    ],
    "total": 1,
    "page_no": 1,
    "page_size": 20
  },
  "timestamp": 1719820800000
}

错误返回 ​

json
{
  "ret_code": 40001,
  "ret_msg": "invalid access_token"
}