game.queryKYC
此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。
查询游戏 KYC。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST {query_game_kyc_webhook}请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| game_id | string | 是 | 游戏唯一标识(从「查询游戏列表」接口返回的game_id传入) |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败(具体错误码参考公共错误码规范) |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回有效数据,无数据时为null) |
| data.game_id | string | 游戏唯一标识 |
| data.game_name | string | 游戏名(无数据时返回空字符串) |
| data.software_copyright | string | 游戏软著(格式:软著登字第XXXX号,无软著时返回空字符串) |
| data.publishing_license | string | 游戏版号(格式:国新出数字[XXXX]XXXX号,无版号时返回空字符串) |
| data.third_party_license | string | 三方授权(如IP授权、合作授权等信息,无授权时返回空字符串) |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 |
cURL 请求
bash
curl -X POST \
{query_game_kyc_webhook} \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"game_id": "game_10001"
}'成功返回
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"game_id": "game_10001",
"game_name": "欢乐消消乐",
"software_copyright": "软著登字第1234567号",
"publishing_license": "国新出数字[2024]123号",
"third_party_license": "乐元素IP授权(授权编号:LYS-2024-001)"
}
}