game.updateAuditStatus
本接口应在服务器端调用,前置步骤请参考接口调用凭证。
更新指定游戏的审核状态,操作结果同步至SUD OpenPaaS平台。 业务场景:平台审核人员完成游戏审核后,将审核结果同步至SUD平台,保障数据一致。幂等性说明:接口基于game_id实现幂等,重复调用相同参数的请求不会重复更新数据。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST https://{api-domain}/open-api/game/update-audit-status请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| game_id | string | 是 | 游戏唯一标识(SUD OpenPaaS平台内) | |
| audit_status | string | 是 | 目标审核状态(枚举值:pending/passed/rejected) | |
| audit_remark | string | 否 | 审核备注(驳回时必填,说明驳回原因) |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回有效数据) |
| data.game_id | string | 游戏唯一标识(SUD OpenPaaS平台内) |
| data.new_audit_status | string | 更新后的审核状态 |
| data.update_time | string | 更新时间(格式:yyyy-MM-dd HH:mm:ss) |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 |
cURL 请求
bash
curl -X POST \
'https://{api-domain}/open-api/game/update-audit-status' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"game_id": "sud_game_10001",
"audit_status": "rejected",
"audit_remark": "游戏内容不符合平台规范"
}'成功返回
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"game_id": "sud_game_10001",
"new_audit_status": "rejected",
"update_time": "2024-05-21 10:15:30"
}
}