络谱认证接口
提供身份证号码验证和人脸图片与身份验证的功能。
接口调用需求
appKey:合作方appkey,在络谱合作方控制台签约认证后可自行创建测试账户。
appSecret:合作方appSecret, 在络谱合作方控制台签约认证后可自行创建测试账户。
接口列表
二要素核验
接口说明:判断所给的姓名和身份证号是否相符。
请求方式:POST
请求地址:https://face.brop.cn/verify/twoInfo.json
参数列表:
名称 | 类型 | 描述 |
---|---|---|
name | String | 姓名 |
cardNo | String | 身份证号 |
random | String | 业务随机数,长度不超过40,不能重复 |
appKey | String | 合作方appkey |
sign | String | 摘要的Base64字符 |
返回结果:验证的结果
返回示例:
{
"code":"SUCCESS",
"detail": {
"ifPair": true,
"reqId": "12356554412553"
}
}
参数列表:
名称 | 类型 | 描述 |
---|---|---|
ifPair | boolean | 姓名身份证是否相符 |
reqId | String | 请求序列号 |
三要素核验
接口说明:判断所给的姓名和身份证号与人脸图片是否相符。
请求方式:POST
请求地址:https://face.brop.cn/verify/threeInfo.json
参数列表:
名称 | 类型 | 描述 |
---|---|---|
name | String | 姓名 |
cardNo | String | 身份证号 |
faceImage | String | 人脸 base64编码,长度不超过40960 |
random | String | 业务随机数,长度不超过40,不能重复 |
appKey | String | 合作方appkey |
sign | String | 摘要的Base64字符 |
返回结果:验证的结果
返回示例:
{
"code":"SUCCESS",
"detail": {
"ifPair": true,
"ifPass": false,
"reqId": "12356554412553"
}
}
参数列表:
名称 | 类型 | 描述 |
---|---|---|
ifPair | boolean | 姓名身份证是否相符 |
ifPass | boolean | 身份证人脸图片是否相符 |
reqId | String | 请求序列号 |
签名方式说明
二要素接口请求的签名
签名内容包括:appKey,name,cardNo,random,appSecret
步骤一 : 将字符串按照顺序连接在一起。 //String msg = appKey + name + cardNo + random + appSecret;
步骤二 : 通过UTF-8编码将msg字符串转化成二进制数据。 //byte[] msgBytes = msg.getBytes("UTF-8");
步骤三 : 对msgBytes做sha-256摘要
三要素接口请求的签名
签名内容包括:appKey,name,cardNo,faceImage,random,appSecret
步骤一 : 将字符串按照顺序连接在一起。 //String msg = appKey + name + cardNo + faceImage + random + appSecret;
步骤二 : 通过UTF-8编码将msg字符串转化成二进制数据。 //byte[] msgBytes = msg.getBytes("UTF-8");
步骤三 : 对msgBytes做sha-256摘要
接口错误码
错误码 | 描述 |
---|---|
SUCCESS | 成功 |
PARAM_VAL_ERROR | 参数错误 |
RANDOM_EXIST | 随机数已存在 |
KEY_NOT_FOUND | 账户不存在 |
SIGN_ERROR | 签名错误 |
DEV_COUNTER_FULL | 测试环境次数已满 |
SYSTEM_ERROR | 系统内部错误 |
KEY_STATUS_ERROR | 账户状态异常 |
THIRD_PARTY_ERROR | 第三方服务异常 |
IMG_TOO_BIG | 请使用40k以内的图片 |