Skip to content

game.queryICP ​

此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。

按游戏包名查询 ICP 备案信息。对齐 ThirdPartyPlatformGameIcp;参考实现见 helloOP GET /developer/game/icp-filing。每个游戏至多一条备案;无数据时仍返回嵌套结构,字段为空或空数组。枚举类字段返回文案(非数字码)。

调用方式:

  • HTTPS 调用

HTTPS 调用 ​

http
POST {query_game_icp_webhook}

请求参数 - Header ​

属性类型默认值必填说明
Authorizationstring是格式:Bearer {access_token}

请求参数 - Body ​

属性类型默认值必填说明
bundle_idstring是游戏包名(从 game.queryList 返回的 bundle_id 传入)

返回值 ​

Object ​

返回的 JSON 数据包

属性类型说明
ret_codeinteger响应码:0 表示成功,非0 表示失败
ret_msgstring响应描述信息:成功返回 "success",失败返回具体错误原因
dataobject业务数据体(仅 ret_code=0 时返回)
data.license_nostring备案证件号
data.subject_infoobject主办方信息
data.subject_info.subject_typestring主办方性质文案(如:个人、企业、事业单位、政府机关)
data.subject_info.license_typestring证件类型文案(如:居民身份证、营业执照)
data.subject_info.subject_namestring主体名称
data.subject_info.license_nostring主体证件号
data.subject_info.license_picarray证件照片 URL 列表
data.subject_info.license_addressstring证件地址
data.subject_info.business_addressstring通讯地址
data.subject_managerobject主体负责人信息
data.subject_manager.id_typestring证件类型文案(如:居民身份证、护照)
data.subject_manager.id_namestring证件姓名
data.subject_manager.id_picarray证件照片 URL 列表
data.subject_manager.id_nostring证件号
data.subject_manager.mobile_nostring手机号码
data.subject_manager.emailstring电子邮箱
data.subject_manager.emergency_contact_phonestring紧急电话
data.game_icpobject游戏备案信息
data.game_icp.game_namestring游戏名称
data.game_icp.game_idstring游戏备案侧游戏 ID
data.game_icp.service_contentstring服务内容
data.game_icp.game_langstring游戏语种
data.game_icp.pre_approval_informationobject前置审批信息
data.game_icp.pre_approval_information.typestring审批类型
data.game_icp.pre_approval_information.numberstring审批编号
data.game_icp.pre_approval_information.attachmentsarray审批附件 URL 列表
data.game_managerobject游戏负责人信息,字段同 subject_manager
data.supplementary_materialsobject补充材料
data.supplementary_materials.filing_undertakingarray备案承诺书 URL 列表
data.supplementary_materials.subject_manager_authorization_letterarray主体负责人授权书 URL 列表
data.supplementary_materials.game_manager_authorization_letterarray游戏负责人授权书 URL 列表
timestamplong毫秒时间戳

ret_code 的合法值 ​

值说明最低版本
0请求成功
40001invalid access_token,访问令牌无效或已过期
40003game 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"
}