game.queryList
此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。
查询已上线游戏列表(分页)。对齐 ThirdPartyPlatformGameInfo 核心字段;参考实现见 helloOP GET /developer/game/list。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST {query_game_list_webhook}请求参数 - Header
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| Authorization | string | 是 | 格式:Bearer {access_token} |
请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| page_no | int | 1 | 否 | 页码,从 1 开始 |
| page_size | int | 20 | 否 | 每页条数 |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回;无数据时 list 为 []) |
| data.list | array | 游戏列表 |
| data.list[].bundle_id | string | 游戏包名(后续详情/资质/ICP 拉取的唯一键) |
| data.list[].name | string | 游戏名称 |
| data.list[].version | string | 最新版本号 |
| data.total | long | 总记录数 |
| data.page_no | integer | 当前页码 |
| data.page_size | integer | 每页条数 |
| timestamp | long | 毫秒时间戳 |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| 40001 | invalid 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"
}