Skip to content

cp.queryKYC ​

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

查询开发者/厂商主体资质(KYC)。参考实现中,主体级可用字段与 GET /developer/info 一致;更细的主办方证件、负责人等合规字段见 game.queryICP 的 subject_info / subject_manager。

调用方式:

  • HTTPS 调用

HTTPS 调用 ​

http
POST {query_cp_kyc_webhook}

请求参数 - Header ​

属性类型默认值必填说明
Authorizationstring是格式:Bearer {access_token},主体 ID 从 Token 解析

请求参数 - Body ​

本接口 Body 传空 JSON {} 即可。

属性类型默认值必填说明
(无)object{}是传空 JSON {}

返回值 ​

Object ​

返回的 JSON 数据包

属性类型说明
ret_codeinteger响应码:0 表示成功,非0 表示失败
ret_msgstring响应描述信息:成功返回 "success",失败返回具体错误原因
dataobject业务数据体(仅 ret_code=0 时返回)
data.idstring三方平台主体 ID
data.subject_namestring主体名称
data.subject_typeinteger主体类型:0 个人,1 企业
data.usccstring统一社会信用代码(企业主体)
data.usernamestring登录用户名
data.statusinteger账号状态:0 禁用,1 启用
timestamplong毫秒时间戳

ret_code 的合法值 ​

值说明最低版本
0请求成功
40001invalid access_token,访问令牌无效或已过期
40002cp not found,未找到对应的开发者信息

cURL 请求 ​

bash
curl -X POST \
  {query_cp_kyc_webhook} \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{}'

成功返回 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "id": "a1000000000000000000000000000001",
    "subject_name": "测试企业有限公司",
    "subject_type": 1,
    "uscc": "91110000MA01234567",
    "username": "demo_dev",
    "status": 1
  },
  "timestamp": 1719820800000
}

错误返回 ​

json
{
  "ret_code": 40001,
  "ret_msg": "invalid access_token"
}