• iDface标准版
  • iDface完整版
  • iDface交互版

iDface标准版

人脸身份验证

活体检测

一款基于国家公民中心库及人脸识别技术的身份验证APP,有效验证用户真实身份

ios版SDK

更新时间:2016-07-20

安卓版SDK

更新时间:2016-07-20

PHP版SDK

更新时间:2016-07-20

Java版SDK

更新时间:2016-07-20

REST接口说明

接口集成后,需向我司提交免费测试申请表。点击填写表 >>

(1)APP服务端公网IP绑定

认证系统向静态的互联网IP提供服务,该IP作为调用身份验证接口的指定出口,并且只允许在该IP所在的服务器访问可信身份验证接口。 IP绑定 方式:进入可信官网www.kexin.net->管理中心->服务中心->接口配置,在IP设置版块添加/修改公网IP。

(2)接口账号和密码

接口认证方式为http Digest,可信科技将提供请求接口时使用的账号(akey)和密码(skey),请妥善保管,如需重置请登录可信官网->管理中心, 在服务中心->接口配置中进行重置。

(3)调用方式和参数

字符编码为UTF-8.

所有参数均使用POST方式请求 请求地址:https://api.kexin.net:18443/identity/format/json,其中json代表返回格式,还可以是xml 使用完 整的URL描述(只是用来直观的展现接口,非程序中直接使用代码):

https://client_id:password@ api.kexin.net:18443/identity/format/{json,xml}/?number=211234190002023378&name=王大志& feature_code [0]=….

请求参数说明

number string 身份证号
name string 姓名
feature_code array 图片base64编码,传一张图片
user_ip string APP/用户端的IP

接口权限验证

在调用接口时首先会进行权限验证,如不通过会直接返回信息,不会有下文3.3/3.4/3.5的信息返回;和身份验证结果的格式不同,例如{" status":false,"error":"Not authorized"}

status error
false Not authorized 没有授权
0 Invalid credentials 无效密钥(skey)
false API account has been overdraft 接口账户已透支
false Unknown method 无效方法(URL)

身份验证返回值说明

serial_number 流水号
id_num 身份证号是否有效 0 无状态,1有效,2 无效
name 姓名是否一致 0 无状态,1 一致,2 不一致
validate_result 验证结果 0 系统分析为不是同人,1系统分析为同一人

(当id_num和name等于1时,本值才有效)

similarity 相似度 1~100
err 错误代码 0 默认,无错误 (其他参见下文4.2)
msg 说明

返回json格式示例

[{"serial_number":"34ew5sf5343w2r","id_num":1,"name"1,"validate_result":1,"similarity":89,"err":0,"msg":"\u670d\u52a1\u5f02 \u5e38"}]

返回xml格式示例

<?xml version="1.0" encoding="utf-8"?>

<xml><item><serial_number>1</serial_number><id_num>1</id_num><name>1</name><validate_result>1</validate_result><similarity>

89</similarity><err>0</err><msg>系统分析为同一人</msg></item></xml>

(4)身份验证错误信息

以下错误代码为3.4/3.5中的err值

10 服务异常
101 没有接收到身份证号或为空
102 身份证号输入不是18位
103 没有接收到姓名或为空104
104 没有接收到照片或为空
201 相片质量不合格
202 身份证库中没有此号码
203 缺少参数
204 相片过大
205 身份证库中没有此号码的照片
206 请检查图片编码
900 其他错误

SDK的使用方法

(1)PHP SDK使用方法

首先将分配的akey和skey加入config.php 然后以demo.php为例,注意identity_verification方法的第3个参数是数组类型

(2)JAVA SDK使用方法

将分配的akey和skey配置在demo中的new KexinClient(akey,skey)

iDface完整版

人脸身份验证

活体检测

一款基于国家公民中心库及人脸识别技术的身份验证APP,有效验证用户真实身份

ios版SDK

更新时间:2016-07-20

安卓版SDK

更新时间:2016-07-20

Java版SDK

更新时间:2016-07-20

REST接口说明

接口集成后,需向我司提交免费测试申请表。点击填写表 >>

(1)APP服务端公网IP绑定

认证系统向静态的互联网IP提供服务,该IP作为调用身份验证接口的指定出口,并且只允许在该IP所在的服务器访问可信身份验证接口。 IP绑定 方式:进入可信官网www.kexin.net->管理中心->服务中心->接口配置,在IP设置版块添加/修改公网IP。

(2)接口账号和密码

接口认证方式为http Digest,可信科技将提供请求接口时使用的账号(akey)和密码(skey),请妥善保管,如需重置请登录可信官网->管理中心, 在服务中心->接口配置中进行重置。

(3)调用方式和参数

字符编码为UTF-8.

所有参数均使用POST方式请求 请求地址:https://api.kexin.net:18443/identity/format/json,其中json代表返回格式,还可以是xml 使用完 整的URL描述(只是用来直观的展现接口,非程序中直接使用代码):

https://client_id:password@ api.kexin.net:18443/identity/format/{json,xml}/?number=211234190002023378&name=王大志& feature_code [0]=….

请求参数说明

number string 身份证号
name string 姓名
user_ip string APP/用户端的IP
live_pic_list array 二进制图片
live_code_list array 图片对应的动作码,数组长度与live_pic_list一致

接口权限验证

在调用接口时首先会进行权限验证,如不通过会直接返回信息,不会有下文3.3/3.4/3.5的信息返回;和身份验证结果的格式不同,例如{" status":false,"error":"Not authorized"}

status error
false Not authorized 没有授权
0 Invalid credentials 无效密钥(skey)
false API account has been overdraft 接口账户已透支
false Unknown method 无效方法(URL)
false API closed by Server 无权请求此接口(未开通或被服务端关闭)

身份验证返回值说明

serial_number 流水号
id_num 身份证号是否有效 0 无状态,1有效,2 无效
name 姓名是否一致 0 无状态,1 一致,2 不一致
validate_result 验证结果 0 系统分析为不是同人,1系统分析为同一人

(当id_num和name等于1时,本值才有效)

similarity 相似度 1~100
err 错误代码 0 默认,无错误 (其他参见下文4.2)
msg 说明
live_check 活体检测验证 object
live_check:error_code 活体检测错误码 0 默认,无错误 (参见下文4.2)
live_check:message 活体检测说明
live_check:info 活体检测结果信息 object
info:score 活体检测分数
info:res 活体检测验证结果说明
info:live_status 活体检测验证结果

1,检测到真人;

2,未检测到真人;

3,不确定是否检测到真人

返回json格式示例

[{"id_num":1,"name":1,"validate_result":1,"similarity":56,"err":0,"msg":"\u7cfb\u7edf\u5206\u6790\u4e3a\u540c\u4e00 \u4eba","serial_number":"15f297c52e4c4a3ae48af09f09a0be32","live_check":{"error_code":"0","message":"","info":{"score":"72", "res":"\u68c0\u6d4b\u5230\u771f\u4eba","live_status":1}}}]

返回xml格式示例

<?xml version="1.0" encoding="utf-8"?>

<xml><item><id_num>1</id_num><name>1</name><validate_result>1</validate_result><similarity>56</similarity><err>0</err><msg> 系统分析为同一人</msg> <serial_number>15f297c52e4c4a3ae48af09f09a0be32</serial_number>

<live_check><error_code>0</error_code><message></message><info><score>72</score><res>检测到真人</res><live_status>1</live_ status></info></live_check></item></xml>

(4)身份验证错误信息

以下错误代码为3.3/3.4/3.5中的err值

10 服务异常
101 没有接收到身份证号或为空
102 身份证号输入不是18位
103 没有接收到姓名或为空104
104 没有接收到照片或为空
201 相片质量不合格
202 身份证库中没有此号码
203 缺少参数
204 相片过大
205 身份证库中没有此号码的照片
206 请检查图片编码
900 其他错误

以下错误代码为3.3/3.4/3.5中的live_check:error_code值

错误代码 说明
302 输入动作码串(live_code_list)错误,每一位必须是1-6的数字
303 帧数和动作编码的长度(live_code_list的长度)不一致
304 采集到的图像帧数太少
304-L 处理超时
307 图像有损坏,或格式不支持
309 其它原因

SDK的使用方法

(1)PHP SDK使用方法

首先将分配的akey和skey加入config.php

然后以demo.php为例,注意identity_verification方法的第3个参数是数组类型

(2)JAVA SDK使用方法

将分配的akey和skey配置在demo中的new KexinClient(akey,skey);

iDface交互版

人脸身份验证

活体检测

一款基于国家公民中心库及人脸识别技术的身份验证APP,有效验证用户真实身份

ios版SDK

更新时间:2016-07-20

安卓版SDK

更新时间:2016-07-20

PHP版SDK

更新时间:2016-07-20

Java版SDK

更新时间:2016-07-20

REST接口说明

接口集成后,需向我司提交免费测试申请表。点击填写表 >>

(1)APP服务端公网IP绑定

认证系统向静态的互联网IP提供服务,该IP作为调用身份验证接口的指定出口,并且只允许在该IP所在的服务器访问可信身份验证接口。 IP绑定 方式:进入可信官网www.kexin.net->管理中心->服务中心->接口配置,在IP设置版块添加/修改公网IP。

(2)接口账号和密码

接口认证方式为http Digest,可信科技将提供请求接口时使用的账号(akey)和密码(skey),请妥善保管,如需重置请登录可信官网->管理中心, 在服务中心->接口配置中进行重置。

(3)调用方式和参数

字符编码为UTF-8.

所有参数均使用POST方式请求 请求地址:https://api.kexin.net:18443/identity/format/json,其中json代表返回格式,还可以是xml 使用完 整的URL描述(只是用来直观的展现接口,非程序中直接使用代码):

https://client_id:password@ api.kexin.net:18443/identity/format/{json,xml}/?number=211234190002023378&name=王大志& feature_code [0]=….

请求参数说明

live_pic_list array 二进制图片
live_code_list array 图片对应的动作码,数组长度与live_pic_list一致
user_ip string APP/用户端的IP

接口权限验证

在调用接口时首先会进行权限验证,如不通过会直接返回信息,不会有下文3.3/3.4/3.5的信息返回;和身份验证结果的格式不同,例如{" status":false,"error":"Not authorized"}

status error
false Not authorized 没有授权
0 Invalid credentials 无效密钥(skey)
false API account has been overdraft 接口账户已透支
false Unknown method 无效方法(URL)
false API closed by Server 无权请求此接口(未开通或被服务端关闭)

身份验证返回值说明

serial_number 流水号
error_code 错误码 0 默认,无错误 (参见下文4)
message 说明
info 验证结果信息 { score : '', res : '', live_status : '' }
info:score 分数
info:res 验证结果说明
info:live_status 验证结果

1,检测到真人;

2,未检测到真人;

3,不确定是否检测到真人

返回json格式示例

{"error_code":"0","message":"","info":{"score":"46","res":"\u672a\u68c0\u6d4b\u5230\u771f\u4eba","live_status":2},"service_id" :"41d74fee03323ac8e670261b6f1d0364"}

返回xml格式示例

<?xml version="1.0" encoding="utf-8"?>

<xml>

<item>

<serial_number>1</serial_number>

<id_num>1</id_num>

<name>1</name>

<validate_result>1</validate_result>

<similarity>89</similarity>

<err>0</err>

<msg>系统分析为同一人</msg>

</item>

</xml>

(4)身份验证错误信息

以下错误代码为3.3/3.4/3.5中的error_code值

错误代码 说明
302 输入动作码串(live_code_list)错误,每一位必须是1-6的数字
303 帧数和动作编码的长度(live_code_list的长度)不一致
304 采集到的图像帧数太少
304-L 处理超时
307 图像有损坏,或格式不支持
309 其它原因

SDK的使用方法

(1)PHP SDK使用方法

将分配的akey和skey加入config.php
(2)JAVA SDK使用方法

将分配的akey和skey配置在demo中的new KexinClient(akey,skey);