Skip to content

game.queryDetail

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

根据game_id查询游戏的完整详情(含icon、描述、宣传素材等),用于平台后台展示游戏全量信息。 业务场景:平台运营人员查看单款游戏的详细资料,辅助审核、运营决策。

调用方式:

  • HTTPS 调用

HTTPS 调用

http
POST https://{api-domain}/open-api/game/query-detail

请求参数 - Body

属性类型默认值必填说明
game_idstring游戏唯一标识(SUD OpenPaaS平台内)

返回值

Object

返回的 JSON 数据包

属性类型说明
ret_codeinteger响应码:0 表示成功,非0 表示失败
ret_msgstring响应描述信息:成功返回 "success",失败返回具体错误原因
dataobject业务数据体(仅 ret_code=0 时返回有效数据,无数据时为null)
data.game_idstring游戏唯一标识(SUD OpenPaaS平台内)
data.game_namestring游戏名称
data.game_iconarray游戏icon集(URL格式数组,无icon时返回空数组 []
data.game_descstring游戏描述(无描述时返回空字符串)
data.game_package_urlstring游戏包下载地址(URL格式,无视频时返回空字符串)
data.game_store_videostring游戏宣传视频(URL格式,无视频时返回空字符串)
data.game_store_picarray游戏商店宣传图集(URL格式数组,无宣传图时返回空数组 []
data.audit_statusstring游戏审核状态(枚举值:pending/passed/rejected

ret_code 的合法值

说明最低版本
0请求成功

cURL 请求

bash
curl -X POST \
  'https://{api-domain}/open-api/game/query-detail' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
  "game_id": "sud_game_10001"
}'

成功返回

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "game_id": "sud_game_10001",
    "game_name": "欢乐消消乐",
    "game_icon": [
      "https://game-res.sud.cn/icon/10001_1.png",
      "https://game-res.sud.cn/icon/10001_2.png"
    ],
    "game_desc": "经典三消类休闲游戏,玩法轻松趣味十足,适合全年龄段玩家",
    "game_store_video": "https://game-res.sud.cn/video/10001.mp4",
    "game_package_url": "https://xxx",
    "game_store_pic": [
      "https://game-res.sud.cn/pic/10001_1.jpg",
      "https://game-res.sud.cn/pic/10001_2.jpg"
    ],
    "audit_status": "passed"
  }
}