Skip to content

game.queryKYC ​

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

按游戏包名查询游戏资质(软著、版号等)。对齐 ThirdPartyPlatformGameQualification;参考实现见 helloOP GET /developer/game/qualification。无资质数据时仍返回嵌套结构,字段为空或空数组。

调用方式:

  • HTTPS 调用

HTTPS 调用 ​

http
POST {query_game_kyc_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.software_copyrightobject软件著作权信息
data.software_copyright.certificate_picturestring软著证书图片 URL
data.software_copyright.certificate_numberstring软著登记号
data.software_copyright.authorization_contractsarray授权合同 URL 列表
data.publication_numberobject版号/ISBN 信息
data.publication_number.isbn_picturestring版号/ISBN 图片 URL
data.publication_number.isbnstring版号/ISBN 编号
data.publication_number.registrationstring版署审批登记号
data.publication_number.authorization_contractsarray授权合同 URL 列表
data.supplementary_materialsarray补充材料 URL 列表
data.self_inspectionboolean是否自检(无数据时可为 null)
timestamplong毫秒时间戳

ret_code 的合法值 ​

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