cp.queryKYC
此接口为平台应用(APP)服务端实现,由SUD OpenPaaS服务端调用。
查询开发者/厂商主体资质(KYC)。参考实现中,主体级可用字段与 GET /developer/info 一致;更细的主办方证件、负责人等合规字段见 game.queryICP 的 subject_info / subject_manager。
调用方式:
- HTTPS 调用
HTTPS 调用
http
POST {query_cp_kyc_webhook}请求参数 - Header
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| Authorization | string | 是 | 格式:Bearer {access_token},主体 ID 从 Token 解析 |
请求参数 - Body
本接口 Body 传空 JSON {} 即可。
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| (无) | object | {} | 是 | 传空 JSON {} |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| ret_code | integer | 响应码:0 表示成功,非0 表示失败 |
| ret_msg | string | 响应描述信息:成功返回 "success",失败返回具体错误原因 |
| data | object | 业务数据体(仅 ret_code=0 时返回) |
| data.id | string | 三方平台主体 ID |
| data.subject_name | string | 主体名称 |
| data.subject_type | integer | 主体类型:0 个人,1 企业 |
| data.uscc | string | 统一社会信用代码(企业主体) |
| data.username | string | 登录用户名 |
| data.status | integer | 账号状态:0 禁用,1 启用 |
| timestamp | long | 毫秒时间戳 |
ret_code 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| 40001 | invalid access_token,访问令牌无效或已过期 | |
| 40002 | cp 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"
}