game.queryICP
此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。
按游戏包名查询 ICP 备案信息。对齐 ThirdPartyPlatformGameIcp;参考实现见 helloOP GET /developer/game/icp-filing。每个游戏至多一条备案;无数据时仍返回嵌套结构,字段为空或空数组。枚举类字段返回文案(非数字码)。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST {query_game_icp_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.license_no | string | 备案证件号 |
| data.subject_info | object | 主办方信息 |
| data.subject_info.subject_type | string | 主办方性质文案(如:个人、企业、事业单位、政府机关) |
| data.subject_info.license_type | string | 证件类型文案(如:居民身份证、营业执照) |
| data.subject_info.subject_name | string | 主体名称 |
| data.subject_info.license_no | string | 主体证件号 |
| data.subject_info.license_pic | array | 证件照片 URL 列表 |
| data.subject_info.license_address | string | 证件地址 |
| data.subject_info.business_address | string | 通讯地址 |
| data.subject_manager | object | 主体负责人信息 |
| data.subject_manager.id_type | string | 证件类型文案(如:居民身份证、护照) |
| data.subject_manager.id_name | string | 证件姓名 |
| data.subject_manager.id_pic | array | 证件照片 URL 列表 |
| data.subject_manager.id_no | string | 证件号 |
| data.subject_manager.mobile_no | string | 手机号码 |
| data.subject_manager.email | string | 电子邮箱 |
| data.subject_manager.emergency_contact_phone | string | 紧急电话 |
| data.game_icp | object | 游戏备案信息 |
| data.game_icp.game_name | string | 游戏名称 |
| data.game_icp.game_id | string | 游戏备案侧游戏 ID |
| data.game_icp.service_content | string | 服务内容 |
| data.game_icp.game_lang | string | 游戏语种 |
| data.game_icp.pre_approval_information | object | 前置审批信息 |
| data.game_icp.pre_approval_information.type | string | 审批类型 |
| data.game_icp.pre_approval_information.number | string | 审批编号 |
| data.game_icp.pre_approval_information.attachments | array | 审批附件 URL 列表 |
| data.game_manager | object | 游戏负责人信息,字段同 subject_manager |
| data.supplementary_materials | object | 补充材料 |
| data.supplementary_materials.filing_undertaking | array | 备案承诺书 URL 列表 |
| data.supplementary_materials.subject_manager_authorization_letter | array | 主体负责人授权书 URL 列表 |
| data.supplementary_materials.game_manager_authorization_letter | array | 游戏负责人授权书 URL 列表 |
| timestamp | long | 毫秒时间戳 |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| 40001 | invalid access_token,访问令牌无效或已过期 | |
| 40003 | game not found,未找到对应的游戏信息 |
cURL 请求
bash
curl -X POST \
{query_game_icp_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": {
"license_no": "京ICP备12345678号",
"subject_info": {
"subject_type": "企业",
"license_type": "营业执照",
"subject_name": "测试企业有限公司",
"license_no": "91110000MA01234567",
"license_pic": ["https://cdn.example.com/business_license.png"],
"license_address": "北京市朝阳区xx路xx号",
"business_address": "北京市朝阳区xx路xx号"
},
"subject_manager": {
"id_type": "居民身份证",
"id_name": "张三",
"id_pic": [],
"id_no": "110101199001011234",
"mobile_no": "13800000000",
"email": "zhangsan@example.com",
"emergency_contact_phone": "13900000000"
},
"game_icp": {
"game_name": "示例游戏",
"game_id": "GAME-OP-001",
"service_content": "游戏娱乐",
"game_lang": "简体中文",
"pre_approval_information": {
"type": "版号",
"number": "国新出审[2024]1234号",
"attachments": ["https://cdn.example.com/pub_approval.png"]
}
},
"game_manager": {},
"supplementary_materials": {
"filing_undertaking": [],
"subject_manager_authorization_letter": [],
"game_manager_authorization_letter": []
}
},
"timestamp": 1719820800000
}错误返回
json
{
"ret_code": 40001,
"ret_msg": "invalid access_token"
}