game.queryICP
This interface is implemented by the platform application (APP) server and called by the SUD OpenPaaS server.
Query ICP filing by package name. Aligned with ThirdPartyPlatformGameIcp; reference: helloOP GET /developer/game/icp-filing. At most one filing per game; when empty, still return nested objects with empty fields/arrays. Enum-like fields return label text, not numeric codes.
Invocation method:
- HTTPS call
HTTPS Call
http
POST {query_game_icp_webhook}Request Parameters - Header
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| Authorization | string | Yes | Format: Bearer {access_token} |
Request Parameters - Body
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| bundle_id | string | Yes | Package name from game.queryList |
Return Value
Object
Returned JSON packet
| Property | Type | Description |
|---|---|---|
| ret_code | integer | 0 success, non-zero failure |
| ret_msg | string | "success" or error reason |
| data | object | Business body (when ret_code=0) |
| data.license_no | string | Filing license number |
| data.subject_info | object | Filing subject |
| data.subject_info.subject_type | string | Subject type label (e.g. individual, enterprise) |
| data.subject_info.license_type | string | License type label |
| data.subject_info.subject_name | string | Subject name |
| data.subject_info.license_no | string | Subject license number |
| data.subject_info.license_pic | array | License photo URL list |
| data.subject_info.license_address | string | License address |
| data.subject_info.business_address | string | Business / contact address |
| data.subject_manager | object | Subject manager |
| data.subject_manager.id_type | string | ID type label |
| data.subject_manager.id_name | string | Name on ID |
| data.subject_manager.id_pic | array | ID photo URL list |
| data.subject_manager.id_no | string | ID number |
| data.subject_manager.mobile_no | string | Mobile number |
| data.subject_manager.email | string | |
| data.subject_manager.emergency_contact_phone | string | Emergency phone |
| data.game_icp | object | Game ICP filing |
| data.game_icp.game_name | string | Game name |
| data.game_icp.game_id | string | Filing-side game ID |
| data.game_icp.service_content | string | Service content |
| data.game_icp.game_lang | string | Game language |
| data.game_icp.pre_approval_information | object | Pre-approval information |
| data.game_icp.pre_approval_information.type | string | Approval type |
| data.game_icp.pre_approval_information.number | string | Approval number |
| data.game_icp.pre_approval_information.attachments | array | Attachment URL list |
| data.game_manager | object | Game manager; same fields as subject_manager |
| data.supplementary_materials | object | Supplementary materials |
| data.supplementary_materials.filing_undertaking | array | Filing undertaking URLs |
| data.supplementary_materials.subject_manager_authorization_letter | array | Subject manager authorization letter URLs |
| data.supplementary_materials.game_manager_authorization_letter | array | Game manager authorization letter URLs |
| timestamp | long | Millisecond timestamp |
Valid values of ret_code
| Value | Description | Min version |
|---|---|---|
| 0 | Success | |
| 40001 | invalid access_token | |
| 40003 | game not found |
cURL Request
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"
}'Success Response
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"license_no": "京ICP备12345678号",
"subject_info": {
"subject_type": "企业",
"license_type": "营业执照",
"subject_name": "Example Tech Co., Ltd.",
"license_no": "91110000MA01234567",
"license_pic": ["https://cdn.example.com/business_license.png"],
"license_address": "Chaoyang, Beijing",
"business_address": "Chaoyang, Beijing"
},
"subject_manager": {
"id_type": "居民身份证",
"id_name": "Zhang San",
"id_pic": [],
"id_no": "110101199001011234",
"mobile_no": "13800000000",
"email": "zhangsan@example.com",
"emergency_contact_phone": "13900000000"
},
"game_icp": {
"game_name": "Demo Game",
"game_id": "GAME-OP-001",
"service_content": "Game entertainment",
"game_lang": "Simplified Chinese",
"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
}Error Response
json
{
"ret_code": 40001,
"ret_msg": "invalid access_token"
}