game.queryKYC
此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。
按游戏包名查询游戏资质(软著、版号等)。对齐 ThirdPartyPlatformGameQualification;参考实现见 helloOP GET /developer/game/qualification。无资质数据时仍返回嵌套结构,字段为空或空数组。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST {query_game_kyc_webhook}请求参数 - Header
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| Authorization | string | 是 | 格式:Bearer {access_token} |
请求参数 - Body
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| bundle_id | string | 是 | 游戏包名(从 game.queryList 返回的 bundle_id 传入) |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回) |
| data.software_copyright | object | 软件著作权信息 |
| data.software_copyright.certificate_picture | string | 软著证书图片 URL |
| data.software_copyright.certificate_number | string | 软著登记号 |
| data.software_copyright.authorization_contracts | array | 授权合同 URL 列表 |
| data.publication_number | object | 版号/ISBN 信息 |
| data.publication_number.isbn_picture | string | 版号/ISBN 图片 URL |
| data.publication_number.isbn | string | 版号/ISBN 编号 |
| data.publication_number.registration | string | 版署审批登记号 |
| data.publication_number.authorization_contracts | array | 授权合同 URL 列表 |
| data.supplementary_materials | array | 补充材料 URL 列表 |
| data.self_inspection | boolean | 是否自检(无数据时可为 null) |
| timestamp | long | 毫秒时间戳 |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| 40001 | invalid access_token,访问令牌无效或已过期 | |
| 40003 | game not found,未找到对应的游戏信息 |
cURL 请求
bash
curl -X POST \
{query_game_kyc_webhook} \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json; charset=utf-8' \
-d '{
"bundle_id": "com.example.game.demo"
}'成功返回
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"software_copyright": {
"certificate_picture": "https://cdn.example.com/sc.png",
"certificate_number": "2024SR1234567",
"authorization_contracts": ["https://cdn.example.com/auth1.pdf"]
},
"publication_number": {
"isbn_picture": "https://cdn.example.com/isbn.png",
"isbn": "ISBN-XXXX",
"registration": "版署审批登记号",
"authorization_contracts": []
},
"supplementary_materials": [],
"self_inspection": null
},
"timestamp": 1719820800000
}错误返回
json
{
"ret_code": 40001,
"ret_msg": "invalid access_token"
}