H5认证网关【电子身份】API (IVG000)

本产品通过集成H5视频采集、视频防伪、活体检测、数据核验、等专业认证技术，生成URL或者二维码，嵌入在企业业务场景中，便于终端用户远程实名、实人认证。认证通过后，生成【电子身份码】，方便用户展示与通关的功能。基于公安部授权的官方数据接口，覆盖身份证、港澳通行证、台胞证、中国护照等多种身份证件的核验，有效防范不法分子利用虚假信息或伪假证件违法违规办理各类业务；也可使得拥有在华护照的港澳台同胞在内地的生活便利。整个方案采用了H5技术，流程完整，可根据客户需求定制化，企业接入快捷，极大的节省了企业的研发成本。

客服电话：

400-110-8298

客服时间：

9:30-17:30

联系邮箱：

bd@yushanshuju.com

Show All
产品详情
出入参数
接入信息
常见问题
相关接口

-

产品特点
-

•便民高效
彻底有效地解决网上注册难、不能自助办理、人工识别验证慢、提交辅助证明材料多、办事流程周期长等让人头大的问题，并一定程度上保护了华侨们的财产安全。
•全量数据
直连出入境管理局官方数据库，覆盖全量注册用户信息，实现全范围实时精准调用，有效提高用户体验。

•高识别率

提供企业级稳定、精准的全球大流量数据源，实时查询、比对，降低误识率，结果精准可靠。
-

应用场景
-

•华侨、护照、身份核验

按照《中华人民共和国出境入境管理法》规定，华侨、、中国公民、港澳台居民等在中国境内办理金融、教育、医疗、交通、电信、社会保险、财产登记等事务需要对其身份及证件进行核实。

•全场景身份核查

适用于全行业场景服务，具体服务场景包括：公证处认证、互联网注册、购买火车票、入住酒店、网上预约就诊、办理电话卡、使用公共交通设备、开通银行账户等。有效与同类身份核验产品（公民、港澳台胞、在华居住外国人口核验等）互补，实现全客户身份核验。
-

覆盖体量
-

身份证件、华侨护照、港澳台居民等持有用户全覆盖
-

产品标签
-

身份认证、KYC、OCR
-

常见问题
-

1.低版本Android包括6.0在内，ios包括14.2版本在内(低版本时，用户需要自己拍摄3-5S视频上传认证）。
2.假设Android手机，当用户点击禁止访问摄像头时，如再想认证需全部退出界面重新进入再认证。

3.网络波动较大情况下，认证可能延迟。

4.录制时应保持面部清晰，否则人脸识别将不准确。

5.验证必须本人验证，与输入信息保持一致。

6.录制视频时手机保持平稳，身体不要过度摇晃。
-

相关接口
-

H5认证网关【电子身份】结果查询API
点击跳转https://www.yushanshuju.com/ords/f?p=888:2:::NO::P2_prodid:IVG001

羽山数据API产品详细介绍

Report Settings

ToggleEdit产品ID
ToggleEdit分类
ToggleEditrn

分类 : 输入字段
名称	说明	备注
name	姓名	选填
card	证件号	选填
card_type	证件类型	必填 102 居民身份证 414 中国护照(含华侨) 511 台湾居民来往大陆通行证(台胞证) 516 港澳居民来往内地通行证 553 外国人永久居留身份证
callback_url	回调地址	必填通知信息， * 具体结果查看,请调用(IVG001) 回调形式:post application/json { "token":"", //token值＂result＂:＂1＂//1 认证通过 //0 认证不通过 }
redirect_url	跳转地址	选填认证通过后，跳转至商户页面进行后续流程。
result_qrcode_display	是否显示认证结果二维码	选填 1是, 0否, 默认0 二维码解密内容: { ＂request_sn＂: ＂XXXX＂,//请求交易号＂name＂:＂XXX＂,//姓名＂cardNo＂:＂XX＂,//证件号＂refreshed＂: ＂1623209060＂//二维码最后刷新时间 }
result_qrcode_expire	二维码过期时间,单位:秒	选填默认0 不过期
require_auth_url_qrcode	是否需要生成身份认证页面url二维码	选填 1是,0否, 默认0
auto_redirect	认证完成后自动跳转时间(单位: 秒)	选填 0: 不跳转默认0 n秒后跳转 n大于1
ext_col	扩展参数	选填 json格式字符串 require_ocr 是否需要证件ocr, string类型, 1是, 0否, 默认0 allow_manual_input 是否允许手动输入证件号和姓名, string类型, 1是, 0否, 默认1 strict_mode 是否使用严格模式（人脸视频必须只有一张脸且必须睁眼） , string类型, 1是, 0否, 默认0 格式如: ＂ext_col＂: ＂{\＂require_ocr\＂:\＂1\＂,\＂allow_manual_input\＂:\＂0\＂\＂strict_mode \＂:\＂0\＂}＂
分类 : 返回字段
名称	说明	备注
auth_url	身份认证页面url	H5 身份认证网关的访问地址
auth_url_qrcode	身份认证页面二维码(base64格式)	提供给用户的二维码，进行人脸核验。
token	token	用以回调函数时，获得匹配结果。

羽山数据API产品接入信息

Report Settings

ToggleEdit分类
ToggleEditrn

分类 : 业务异常(retcode)
名称	说明
warn_001	认证请求失败
分类 : 系统代码(retcode)
名称	说明
000000	交易成功（收费）
200000	调用远程数据异常
200010	账号不存在
200012	未找到账号与产品的订购关系
200014	加解密错误
200013	该产品测试条数已用完，请联系羽山数据
err_015	数据源请求时出现异常
err_012	传入参数不正确

羽山数据API产品接入信息

Report Settings

ToggleEdit分类
ToggleEditrn

分类 : 1.对接信息
名称	说明
IP白名单	本系统具有IP白名单限制，需要先请确认自身服务器公网IP已由羽山数据运维工程师加入
协议	HTTP/HTTPS POST
编码格式	UTF8
HEAD: ACCT_ID	必填，开户后将获得接入账号APP_ID，如“test_user”
HEAD: CONTENT-TYPE	application/json
测试环境URL	http://122.152.195.249:21000/credit-gw/service
生产环境URL	https://api.yushanshuju.com/credit-gw/service
明文Request JSON样例	{ "prod_id": "IVG000", "req_data": { 这里是业务入参 }, "req_time": 1545270159122, "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"}
明文Request JSON样例说明	prod_id 为产品编号。req_data 为业务入参，请参考下面详细信息。小于br大于req_time 为Linux 毫秒时间，可使用echo `date +%s`"000" 命令获得最新时间。request_sn为请求单号，不可重复，需自行生成。
明文Response JSON样例	{ "response_sn": "20190602020740639KIBG", "retdata": { "final_auth_result": "1" }, "version": "1.0", "request_sn": "4a5f3f52e5324a87b96e16c0585", "retmsg": "交易成功", "retdate": 1559412461182, "retcode": "000000" }
明文Response JSON样例说明	response_sn 返回单号。 retdata 返回业务json。 retmsg 返回描述。 retcode 系统代码。
技术支持	13764219628 阿南
分类 : 2.加解密方法
名称	说明
私钥	登录系统或联系技术支持获得接入KEY，加密JSON Request 和解密response密文时需要使用。注意要严格保密使用，请勿外泄，如有遗失，自行负责！
请求报文加密算法	将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法	将response JSON使用base64解码后,aes-128-cbc解密为明文.
加解密样例(Linux 命令)	##加密命令实现 echo -n '{"prod_id":"P_C_B008","req_data":{"cardNo":"120105198504090312","name":"刘北"}, "req_time":1545270159122,"request_sn":"4df1e3c9583d40a9a57f63e4ab153189"}' \| openssl aes-128-cbc -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 \|base64 -w 0 ##解密命令实现 echo -n 'lQCG4JX7L0VwyAMBP7v05DwqdgVRiKEp6ExdIvlyCVpvDCSc671小于br大于csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+小于br大于o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d小于br大于ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW小于br大于kOGF8uqc57sKLzVVzgvdTZuoHWWwoyPmKUXq9dNw等于等于' \| base64 -d \| openssl aes-128-cbc -d -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 -p
分类 : 公共参数
名称	说明
request_sn	请求序列号
acct_id	账号
prod_id	产品ID
req_data	传入参数
req_time	请求时间
response_sn	返回单号
retdata	返回参数
retcode	返回代码
retmsg	返回信息
retdate	返回时间戳

-

常见问题
-

1.低版本Android包括6.0在内，ios包括14.2版本在内(低版本时，用户需要自己拍摄3-5S视频上传认证）。
2.假设Android手机，当用户点击禁止访问摄像头时，如再想认证需全部退出界面重新进入再认证。

3.网络波动较大情况下，认证可能延迟。

4.录制时应保持面部清晰，否则人脸识别将不准确。

5.验证必须本人验证，与输入信息保持一致。

6.录制视频时手机保持平稳，身体不要过度摇晃。

-

1 - 1

-

相关接口
-

H5认证网关【电子身份】结果查询API
点击跳转https://www.yushanshuju.com/ords/f?p=888:2:::NO::P2_prodid:IVG001

-

1 - 1

prod

H5认证网关【电子身份】API (IVG000)

New

pic

产品特点

-

•高识别率

应用场景

-

•华侨、护照、身份核验

•全场景身份核查

覆盖体量

-

产品标签

-

常见问题

-

1.低版本Android包括6.0在内，ios包括14.2版本在内(低版本时，用户需要自己拍摄3-5S视频上传认证）。

2.假设Android手机，当用户点击禁止访问摄像头时，如再想认证需全部退出界面重新进入再认证。

3.网络波动较大情况下，认证可能延迟。

4.录制时应保持面部清晰，否则人脸识别将不准确。

5.验证必须本人验证，与输入信息保持一致。

6.录制视频时手机保持平稳，身体不要过度摇晃。

相关接口

-

H5认证网关【电子身份】结果查询API

出入参数

羽山数据API产品详细介绍

Report Settings

羽山数据API产品接入信息

Report Settings

羽山数据API产品接入信息

Report Settings

常见问题

-

1.低版本Android包括6.0在内，ios包括14.2版本在内(低版本时，用户需要自己拍摄3-5S视频上传认证）。

2.假设Android手机，当用户点击禁止访问摄像头时，如再想认证需全部退出界面重新进入再认证。

3.网络波动较大情况下，认证可能延迟。

4.录制时应保持面部清晰，否则人脸识别将不准确。

5.验证必须本人验证，与输入信息保持一致。

6.录制视频时手机保持平稳，身体不要过度摇晃。

相关接口

-

H5认证网关【电子身份】结果查询API

API推荐

食品添加剂生产许可证

从业人员查询

行驶证三要素检验

人像分割

多类型证件OCR自动识别

企业开户信息查询

企业道路运输经营许可证验证V3

列入严重违法失信企业名单黑名单信息查询