接口描述
当开发者不使用e签宝的个人实名认证时，需要将个人实名认证的相关证据上传至e签宝获取证据点ID，并在后续创建e签宝签署账号时传入该证据点ID。
接口地址
点击下述蓝色字体{host}可跳转至API请求域名说明文档
https://{host}/v3/evidence/evi-point/psn-realname
请求方式
POST
请求数据格式
application/json; charset=UTF-8
请求参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数位置 | 参数说明 | |
eviName | string | 是 | Body | 证据点名称（不能超过64个字符） | |
customBizId | string | 否 | Body | 开发者自定义业务编号（不能超过36个字符） | |
realNameMethod | string | 是 | Body | 实名方式 THREEELEMENTS - 运营商三要素 BANKCARDFOUR - 银行卡四要素 FACE - 人脸认证 | |
timeStamp | long | 是 | Body | 实名完成时间（毫秒级时间戳） | |
name | string | 是 | Body | 个人姓名 | |
cardNo | string | 是 | Body | 个人证件号 | |
cardType | string | 是 | Body | 个人证件类型 CRED_PSN_CH_IDCARD - 中国大陆居民身份证（默认值） CRED_PSN_CH_HONGKONG - 香港来往大陆通行证（回乡证） CRED_PSN_CH_MACAO - 澳门来往大陆通行证（回乡证） CRED_PSN_CH_TWCARD - 台湾来往大陆通行证（台胞证） CRED_PSN_PASSPORT - 护照 CRED_PSN_FOREIGN - 外国人永久居住证 CRED_PSN_OTHER - 其他 | |
cardPortrait | string | 是 | Body | 证件人像面
| |
cardNationalEmblem | string | 是 | Body | 证件国徽面
| |
mark | string | 否 | Body | 备注信息 | |
threeElements | object | 否 | Body | 运营商三要素实名信息
| |
infoVerifySupplier | string | 是 | Body | 信息核验供应商 | |
verifyTime | string | 是 | Body | 核验时间 | |
verifySerialNumber | string | 是 | Body | 核验流水号 | |
mobile | string | 是 | Body | 认证手机号 | |
smsCode | string | 是 | Body | 短信验证码 | |
smsSupplier | string | 是 | Body | 短信供应商 | |
bankCardFour | object | 否 | Body | 银行卡四要素实名信息
| |
infoVerifySupplier | string | 是 | Body | 信息核验供应商 | |
verifyTime | string | 是 | Body | 核验时间 | |
verifySerialNumber | string | 是 | Body | 核验流水号 | |
openingBank | string | 是 | Body | 开户行 | |
bankCard | string | 是 | Body | 银行卡号 | |
mobile | string | 是 | Body | 银行卡绑定手机号 | |
smsCode | string | 是 | Body | 短信验证码 | |
smsSupplier | string | 是 | Body | 短信供应商 | |
face | object | 否 | Body | 人脸认证实名信息
| |
infoVerifySupplier | string | 是 | Body | 信息核验供应商 | |
verifyTime | string | 是 | Body | 核验时间 | |
verifySerialNumber | string | 是 | Body | 核验流水号 | |
faceImage | string | 是 | Body | 人脸照片
| |
faceImageSimilarScore | string | 是 | Body | 人脸照片相似度得分 | |
faceLiveDetectScore | string | 是 | Body | 人脸活体检测得分 | |
响应参数
展开全部参数参数名称 | 参数类型 | 必选 | 参数说明 | |
code | int32 | 是 | 业务码，0表示成功，非0表示异常。 | |
message | string | 否 | 业务信息 请根据 code 来判断错误情况，不应该依赖 message 匹配，因为 message 可能会调整。 | |
data（点击“+”展开详情） | object | 否 | 业务数据 | |
eviPointId | string | 否 | 证据点ID（以P开头） | |
请求示例
{
"eviName": "测试张三-个人实名证据",
"realNameMethod": "THREEELEMENTS",
"timeStamp": "1742809059000",
"name": "测试张三",
"cardNo": "130401199601018395",
"cardType": "CRED_PSN_CH_IDCARD",
"cardPortrait": "9631665ce202447bb254ab57a391808c",
"cardNationalEmblem": "02723880e8da4611acc7a6d9ffe93f68",
"threeElements": {
"infoVerifySupplier": "信息核验供应商名字",
"verifyTime": "20240324",
"verifySerialNumber": "No1234567",
"mobile": "19800002222",
"smsCode": "123456",
"smsSupplier": "短信供应商名字"
}
}响应示例
{
"code": 0,
"message": null,
"data": {
"eviPointId": "P1904811111836663815"
}
}
我要纠错