Skip to content

game.listByAuditStatus

本接口应在服务器端调用,前置步骤请参考接口调用凭证

按审核状态批量查询游戏列表,支持分页,用于平台后台展示不同审核阶段的游戏清单。 业务场景:平台运营人员筛选待审核/已通过/驳回的游戏,快速定位目标游戏。

调用方式:

  • HTTPS 调用

HTTPS 调用

http
POST https://{api-domain}/open-api/game/list-by-audit-status

请求参数 - Body

属性类型默认值必填说明
audit_statusstring游戏审核状态(枚举值:pending-待审核、passed-审核通过、rejected-审核驳回)
page_numinteger1页码
page_sizeinteger20每页条数,最大值:100

返回值

Object

返回的 JSON 数据包

属性类型说明
ret_codeinteger响应码:0 表示成功,非0 表示失败
ret_msgstring响应描述信息:成功返回 "success",失败返回具体错误原因
dataobject业务数据体(仅 ret_code=0 时返回有效数据)
data.totalinteger符合条件的游戏总数
data.listarray游戏列表(无数据时返回空数组 []
data.list[].game_idstring游戏唯一标识(SUD OpenPaaS平台内)
data.list[].game_namestring游戏名称
data.list[].audit_statusstring游戏审核状态(同请求参数枚举值)
data.list[].audit_timestring审核时间(格式: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": ""
      }
    ]
  }
}