game.queryDetail
本接口应在服务器端调用,前置步骤请参考接口调用凭证。
根据game_id查询游戏的完整详情(含icon、描述、宣传素材等),用于平台后台展示游戏全量信息。 业务场景:平台运营人员查看单款游戏的详细资料,辅助审核、运营决策。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST https://{api-domain}/open-api/game/query-detail请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| game_id | string | 是 | 游戏唯一标识(SUD OpenPaaS平台内) |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回有效数据,无数据时为null) |
| data.game_id | string | 游戏唯一标识(SUD OpenPaaS平台内) |
| data.game_name | string | 游戏名称 |
| data.game_icon | array | 游戏icon集(URL格式数组,无icon时返回空数组 []) |
| data.game_desc | string | 游戏描述(无描述时返回空字符串) |
| data.game_package_url | string | 游戏包下载地址(URL格式,无视频时返回空字符串) |
| data.game_store_video | string | 游戏宣传视频(URL格式,无视频时返回空字符串) |
| data.game_store_pic | array | 游戏商店宣传图集(URL格式数组,无宣传图时返回空数组 []) |
| data.audit_status | string | 游戏审核状态(枚举值: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"
}
}