络谱认证接口
提供身份证号码验证和人脸图片与身份验证的功能。
接口调用需求
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以内的图片 |