接口描述
上传用户的人脸照片,与用户的姓名、证件号,核验照片是否为本人,接口将返回信息比对的结果。
接口地址
/v2/identity/verify/individual/faceCompare/withoutSource
请求方式
POST
请求头
提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。
方式一:请求签名鉴权(优先推荐)
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 应用ID |
Content-Type | string | 是 | application/json;charset=UTF-8 |
X-Tsign-Open-Ca-Timestamp | string | 是 | API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击 |
Accept | string | 是 | 建议统一填写 */* |
X-Tsign-Open-Ca-Signature | string | 是 | 签名字符串 |
Content-MD5 | string | 是 | 当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。 |
X-Tsign-Open-Auth-Mode | string | 是 | 选择请求方式进行鉴权,固定值,Signature |
方式二:OAuth2.0鉴权(不推荐使用)
当安全接入选择OAuth2.0鉴权方式,请点击查阅详情。
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
name | string | 是 | body | 姓名 |
idNo | string | 是 | body | 身份证号 |
faceImgBase64 | string | 是 | body | 人像照片Base64编码 注:不包含格式前缀 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |||
code | int | 是 | 业务码,0表示成功 | |||
message | string | 是 | 信息 | |||
data | object | 否 | 业务信息 | |||
verifyId | string | 否 | 信息比对业务Id,请注意保存该参数 | |||
confidence | int | 否 | 库照比对综合分数,取值:[0,100]
|
请求示例
{
"name":"xx",
"idNo":"330204xxxxxxxx1221",
"faceImgBase64":"iVBORw0KGgoAAAANSUhEUgAAARAAAACICAYAAAAvSLSPAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAAAbESURBVHhe7d09bttKFIDRt7TsIDvINrIA9dlJatdqs4a0atOm1Hs38DXmTUiKvhGECQ+WMV82nIBPQ/V4AiAQHKBAQoExCgTECAMgEBygQEKBMQoExAgDIBAcoEBCgTEKBMQIAyAQHKBAQoExCgTECAMgEBygQEKBMQoExAgDIBAcoEBCgTEKBMQIAyAWl8//79+uXLl+uvX79e36n79u3b9evXr9ffv3+/vgP7IyCNRwUkovHy8nL99OnTn2PCXglI4z0B+fnz5/Xz589/IlEdsUqBZ3a4gPz48WNwMs8Z7SVJBiSOVxHxEBCe3WYCEpOpn6RLiAkfEz8C0IsVyNj5+3saAgIbCEhM2ghH3DOIy4c1A9JHojUnIPE6PksflfyM7fsCwh6sGpCYUDkp477DmgGJc8a5xyb1rbi0q6c4drzO81wul7fjx3bCwV5s5hJm7YDk+eeuTtogtCuLPE68HyNe9zdlY0Uydh54JgLyKv8FJs4/9POpFUiKY/fRyNVJG5lWnCfOl8GpDkFiDQLyn5zEOcmHJv1UQNoIxHa9obDAHhw+IDn5YwXS6iMyFJA2HO0xx+TN1DnbwjM4dEByQvfxSG1E2oDEiNe5b243d5zP57f9M1DwjA4ZkJzIcy4pMhyn02n0d4ttYtySKxbRYC+eLiA5CauXAe0K5D3aFUhPQDiqpwtIXnbEGLv0mCIg8DirBiSjkUHox9CkzElYiUC4JyBjkRAQjmozK5CPMjcg7UonxtQ+EY9221tDQNiLwwVkCVYgHJWAAGUCApQJCFAmIECZgABlAgKUCQhQJiBAmYAAZQIClAkIUCYgQJmAAGUCApQJCFAmII14iNCcBy3PEc8HufV4Rnh2AtJ4VEAiGvHHwuPpY5XntsKzEJDGewKSTxfrH1f4ntE+xax/hOJ7hkixlsMFJB4nODQJ54z2kuTexxPOfQwibNnqARl6MvuS36hTD1WO80796QYBgf9bNSAZj3YS5lJ+qYhMBaSPRGtOQOJ1/O59VPIzte8LCHuwuUuYmKAxUR/1ryG9sYDkeccm9a24RCDy53HseJ3nuVwub8eP7YSDvdjkPZCYYB8dkFwNzV2dtEFoVxb9JdnQ54gVydh54JlYgbyKSR3nbFcOrakVSIpj99HI1UkbGdiLzQUkJ+FSy/yhgMTreC8n+dCknwpI7j/2e+dnWiqKsJZNBSQn4tAK4FH6gOQ5+5u2fUSGAtKGY87vnDdTl/x88JE2E5D23kH7zf9obUByQvfxSG1E2oDkZVbum9vNHefz+W3/JT8rLG0TAfmoeIQ4fk7kOZcUGY7T6fTXCiTFNjFuyRWLaLAXqwek/za/JSdh9TIgJm9l33YF0hMQjmrVgLw3HiEvO96zT0tA4HFWDUhMpIzB0BialDkJKxEI9wRkLBL3BKS9fLtnjMUNlrSZm6gfZW5A2pVOjKl9Ih7ttreGFQh7cbiALOGeFQg8MwEBygQEKBMQoExAgDIBAcoEBCgTEKBMQIAyAQHKBAQoExCgTECAMgEBygQEKBMQoExAGvEQoUf97ZZ4PoinhLF3AtJ4VEAiGi8vL3+ePjbnua3ts2ErQ6hYi4A03hOQfLrY0ISeO+Y8xQy27HABiccJDk3mOaP9pr/38YRzH4MIW7ZqQMaW7nOW/VVTD1WO845dDvT3NAQENrgCyRXCUhGZCkgfidacgOTv3kclPkv/voCwB5sLSK5KxibyvcYCkucdm9S34hKByJ/HseN1nudyubwdP7YTDvZiswFZapKNBST/wNPc1UkbhHZl0f+hqKGbsrEiGTsPPJPNBWTpyTUWkDhvTPZ25dCaWoGkOHYfjVydtJEZ0odn7hgKFHyUTQQkJ1mOW5PtHkMBidfxXp53aNJPBST3j31iu14cJ35msrM3m1uB5GS89W1f1Qckz9fftO0jMhSQNhztMcfkzdQ528Iz2FxAQn5jtyuAR2kDkhO6j0dqI9IGJEa8zn1zu7njfD6/7b/EZ4SPssmA5Df7UgHJiTznkiLDcTqd/lqBpNgmxi1Lfi5YwyYDEt/qY8v8nIRjP78lJm9l33YF0hMQjmpzAckVwthlRV52TG0zRUDgcVYNSE6oDEKMW5cVuU8lAuGegIxFQkA4qk1ewixpbkDalU6MqX0iHu22t0YbkOr//+iHfyJmDYcLyBKsQDgqAQHKBAQoExCgTECAMgEBygQEKBMQoExAgDIBAcoEBCgTEKBMQIAyAQHKBAQoExCgTECAMgEBygQEKBMQoExAgDIBAcoEBCgTEKBMQIAyAQHKBAQoExCg6Hr9F6DzSgk7uck/AAAAAElFTkSuQmCC"
}
响应示例
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "7a143dab-770e-1111-af21-513938addc51",
"confidence": 99
}
}