game.queryKYC

本接口应在服务器端调用，前置步骤请参考接口调用凭证。

根据game_id查询游戏的KYC资质信息（软著、版号、三方授权等），用于平台审核游戏合规性。 业务场景：平台运营人员核验游戏的合规资质，辅助审核决策。

调用方式：

• HTTPS 调用

HTTPS 调用

POST https://{api-domain}/open-api/game/query-kyc

请求参数 - Body

属性	类型	默认值	必填	说明
game_id	string		是	游戏唯一标识（SUD OpenPaaS平台内）

返回值

Object

返回的 JSON 数据包

属性	类型	说明
ret_code	integer	响应码：0 表示成功，非0 表示失败
ret_msg	string	响应描述信息：成功返回 "success"，失败返回具体错误原因
data	object	业务数据体（仅 ret_code=0 时返回有效数据，无数据时为null）
data.game_id	string	游戏唯一标识（SUD OpenPaaS平台内）
data.game_name	string	游戏名称（无数据时返回空字符串）
data.software_copyright	string	游戏软著（软著证书编号/信息，无软著时返回空字符串）
data.publishing_license	string	游戏版号（版号备案编号，无版号时返回空字符串）
data.third_party_license	string	三方授权（如IP授权、合作授权等信息，无授权时返回空字符串）
data.kyc_audit_status	string	KYC审核状态（枚举值：pending-待审核、passed-审核通过、rejected-审核驳回）

ret_code 的合法值

值	说明	最低版本
0	请求成功

cURL 请求

curl -X POST \
  'https://{api-domain}/open-api/game/query-kyc' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
  "game_id": "sud_game_10001"
}'

成功返回

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "game_id": "sud_game_10001",
    "game_name": "欢乐消消乐（SUD OpenPaaS版）",
    "software_copyright": "软著登字第1234567号",
    "publishing_license": "国新出数字[2024]123号",
    "third_party_license": "乐元素IP授权（授权编号：LYS-2024-001）",
    "kyc_audit_status": "passed"
  }
}