Skip to content

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 ​

PropertyTypeDefaultRequiredDescription
AuthorizationstringYesFormat: Bearer {access_token}

Request Parameters - Body ​

PropertyTypeDefaultRequiredDescription
bundle_idstringYesPackage name from game.queryList

Return Value ​

Object ​

Returned JSON packet

PropertyTypeDescription
ret_codeinteger0 success, non-zero failure
ret_msgstring"success" or error reason
dataobjectBusiness body (when ret_code=0)
data.license_nostringFiling license number
data.subject_infoobjectFiling subject
data.subject_info.subject_typestringSubject type label (e.g. individual, enterprise)
data.subject_info.license_typestringLicense type label
data.subject_info.subject_namestringSubject name
data.subject_info.license_nostringSubject license number
data.subject_info.license_picarrayLicense photo URL list
data.subject_info.license_addressstringLicense address
data.subject_info.business_addressstringBusiness / contact address
data.subject_managerobjectSubject manager
data.subject_manager.id_typestringID type label
data.subject_manager.id_namestringName on ID
data.subject_manager.id_picarrayID photo URL list
data.subject_manager.id_nostringID number
data.subject_manager.mobile_nostringMobile number
data.subject_manager.emailstringEmail
data.subject_manager.emergency_contact_phonestringEmergency phone
data.game_icpobjectGame ICP filing
data.game_icp.game_namestringGame name
data.game_icp.game_idstringFiling-side game ID
data.game_icp.service_contentstringService content
data.game_icp.game_langstringGame language
data.game_icp.pre_approval_informationobjectPre-approval information
data.game_icp.pre_approval_information.typestringApproval type
data.game_icp.pre_approval_information.numberstringApproval number
data.game_icp.pre_approval_information.attachmentsarrayAttachment URL list
data.game_managerobjectGame manager; same fields as subject_manager
data.supplementary_materialsobjectSupplementary materials
data.supplementary_materials.filing_undertakingarrayFiling undertaking URLs
data.supplementary_materials.subject_manager_authorization_letterarraySubject manager authorization letter URLs
data.supplementary_materials.game_manager_authorization_letterarrayGame manager authorization letter URLs
timestamplongMillisecond timestamp

Valid values of ret_code ​

ValueDescriptionMin version
0Success
40001invalid access_token
40003game 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"
}