game.listByAuditStatus
本接口应在服务器端调用,前置步骤请参考接口调用凭证。
按审核状态批量查询游戏列表,支持分页,用于平台后台展示不同审核阶段的游戏清单。 业务场景:平台运营人员筛选待审核/已通过/驳回的游戏,快速定位目标游戏。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST https://{api-domain}/open-api/game/list-by-audit-status请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| audit_status | string | 是 | 游戏审核状态(枚举值:pending-待审核、passed-审核通过、rejected-审核驳回) | |
| page_num | integer | 1 | 是 | 页码 |
| page_size | integer | 20 | 是 | 每页条数,最大值:100 |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回有效数据) |
| data.total | integer | 符合条件的游戏总数 |
| data.list | array | 游戏列表(无数据时返回空数组 []) |
| data.list[].game_id | string | 游戏唯一标识(SUD OpenPaaS平台内) |
| data.list[].game_name | string | 游戏名称 |
| data.list[].audit_status | string | 游戏审核状态(同请求参数枚举值) |
| data.list[].audit_time | string | 审核时间(格式:yyyy-MM-dd HH:mm:ss,未审核时返回空字符串) |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 |
cURL 请求
bash
curl -X POST \
https://{api-domain}/open-api/game/list-by-audit-status \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"audit_status": "passed",
"page_num": 1,
"page_size": 20
}'成功返回
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"total": 2,
"list": [
{
"game_id": "sud_game_10001",
"game_name": "欢乐消消乐",
"audit_status": "passed",
"audit_time": "2024-05-20 14:30:00"
},
{
"game_id": "sud_game_10002",
"game_name": "贪吃蛇大作战",
"audit_status": "pending",
"audit_time": ""
}
]
}
}