络谱认证接口

提供身份证号码验证和人脸图片与身份验证的功能。

接口调用需求

appKey:合作方appkey, 联系我们的商务人员进行申请。

appSecret:合作方appSecret, 联系我们的商务人员进行申请。

接口列表

二要素核验

接口说明:判断所给的姓名和身份证号是否相符。

请求方式:POST

请求地址:http://FACE_HOST:PORT/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

请求地址:http://FACE_HOST:PORT/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以内的图片

results matching ""

    No results matching ""