实人安全认证服务API

更新时间：2019-08-13 08:45:56

获取临时token

/home/paas/person/verify/token/get

版本1.0.0

入参

字段名 类型 必传 备注
apiVersion String 是 api版本号，当前取值1.0.0

出参

返回结果使用通用结果类型，data域是字符串，见下表的详细说明：

参数 类型 描述
data String 临时token，可重复获取，有效期：10min~20min。
base64格式编码

示例

请求示例

{
        "apiVersion":"1.0.0"
}

返回示例

{
    "code":200,
    "data":"token****",
    "message":"success"
}

请求空发ID2

/home/paas/person/verify/id/get

版本1.0.0

入参

字段名 类型 必传 备注
apiVersion String 是 api版本号，当前取值1.1.2
deviceAuthCode String 是 基于空发token生成的设备端认证码，服务端通过其验证设备空发的合法性

出参

返回结果使用通用结果类型，data域是字符串，见下表的详细说明：

参数 类型 描述
data String 加密下发的ID2及密钥信息

示例

请求示例

{
    "apiVersion":"1.0.0",
    "deviceAuthCode":"abcd"
}

返回示例

{
    "code":200,
    "data":"******",
    "message":"success"
}

实人认证

/home/paas/person/verify

版本1.0.0

入参

字段名 类型 必传 备注
apiVersion String 是 api版本号，当前取值1.0.0
id2 String 是 ID²标识，客户端采集人员照片时获得
authCode String 是 客户端生成的认证码，服务端通过检查其有效性验证客户端的合法性，客户端采集人员照片时生成
name String 是 待认证人员的名称
idNumber String 是 待认证人员的身份证号
image String 是 待认证人员的照片，从客户端采集
token String 是 照片的签名信息，客户端采集照片时生成【含有认证机构编码？】
businessCode String 是 组织机构代码(统一社会信用代码)

出参

返回结果使用通用结果类型，data域是对象，见下表的详细说明：

参数 类型 描述
name String 人员名称
idNumber String 被认证人员的身份证号
score Integer 比对分数
result Integer 实人认证结果
resultText String 结果的文本描述

示例

请求示例

{
    "image":"image",
    "businessCode":"91330110MA280U1068",
    "apiVersion":"1.0.0",
    "authCode":"3~2~CA97A54B16513A2E~1559113338910~FeJxeUXSJy85I0+pMKKUI661Gv7mGZHu1Yvc4+H4jSg05mJyGNKQtj1bjp3MlIRU",
    "id2":"000FFFFFDB1D8DD9B1EA9000",
    "name":"金樑樑",
    "idNumber":"33068219930511301X",
    "token":"vdbLScb5g5wWGDeDqqKCYExNWJRQ0o3VvMuG6+P0V73BiH2PYqKlGgv11sS/0sqH+7dRDWdyqQtbvgnTKkV+sa2KG0543btZQsoVqV0W5JDD3Ap6aOY/GbizakdP2iK6hq8PH8g53he2YYKPRATDlEzQL1p0Pe6mCKv57gtthT+pi7HNrefNod9Vw3iXcEK1LrIxXDs4j+2WiKXsDjx/mbmkGqP8m08fySqeHatrl/0="
}

返回示例

{
    "code":200,
    "id":"93ce5b0e-35b6-4183-8a88-e6f52632e144",
    "localizedMsg":"success",
    "message":"success",
    "data":{
        "score":100,
        "result":1,
        "resultText":"认证通过",
        "name":"金樑樑",
        "idNumber":"330682199******301X"
    }
}

results matching ""

    No results matching ""