跳至主内容

prod

New

9:30-17:30
  • -

    产品特点

    -

    •便民高效

    彻底有效地解决网上注册难、不能自助办理、人工识别验证慢、提交辅助证明材料多、办事流程周期长等让人头大的问题,并一定程度上保护了华侨们的财产安全。

    •全量数据

    直连出入境管理局官方数据库,覆盖全量注册用户信息,实现全范围实时精准调用,有效提高用户体验。

    •高识别率

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

  • -

    应用场景

    -

    •华侨、护照、身份核验


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


    •全场景身份核查


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

    •远程开户


    远程证件识别用于开户及认证,通过带有NFC功能的设备读取证件信息后,远程验证证件信息真实性。

  • -

    覆盖体量

    -

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

    产品标签

    -

    身份认证、KYC、NFC
  • -

    常见问题

    -

    1.拍摄证件照时注意避免证件上有反光,不要遮挡重要信息 。
    2.拍摄的时候尽量将整个证件拍摄在内。
    3.护照比较容易反光,拍摄时可选择手持护照拍摄。
    4.拍摄护照时,证件需摆正,护照四边要显示在图片中。
    5.OCR识别后,先点击“提交信息”按钮后,再将带有NFC功能的手机放置在证件上进行NFC读取,NFC读取的中途不能将手机拿走。

出入参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明备注
cardType
证件类型
102 居民身份证
414 中国护照(含华侨)
517 往来港澳通行证
request_sn
请求交易号(保证唯一性)
aes_key
秘钥
acct_id
账号id
分类 : 返回字段
名称说明备注
identity card
居民身份证
headImage          人像
name               姓名
gender             性别
nation             民族
birthDate          出生日期
address            家庭地址
issuingAuthority   签发机关
validStartDate     有效期起始日期
validEndDate       有效期结束日期
passport
护照
headImage          人像
name               姓名
surname            姓氏
gender             性别
personalNumber     个人号码
birthDate          出生日期yyyymmdd
expiryDate         证件有效期yyyymmdd
serialNumber       证件号
nationality        国籍
documentType       卡类型
issuingAuthority   签发机关
cardType           414:护照  
                   517:通行证 
                   102:身份证
hong Kong and Macau Pass
港澳通行证
headImage          人像
name               姓名
surname            姓氏
gender             性别
personalNumber     个人号码
birthDate          出生日期yyyymmdd
expiryDate         证件有效期yyyymmdd
serialNumber       证件号
nationality        国籍
documentType       卡类型
issuingAuthority   签发机关
cardType           414:护照  
                   517:通行证 
                   102:身份证

羽山数据API产品接入信息

报表设置

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

羽山数据API产品接入信息

报表设置

分类 : 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": "NFC001",
  "req_data": {
    这里是业务入参
  },
  "req_time": 1545270159122,
  "request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
}
明文Request JSON样例说明
prod_id 为产品编号。req_data 为业务入参,请参考下面详细信息。
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
csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+
o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d
ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW
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.拍摄证件照时注意避免证件上有反光,不要遮挡重要信息 。
    2.拍摄的时候尽量将整个证件拍摄在内。
    3.护照比较容易反光,拍摄时可选择手持护照拍摄。
    4.拍摄护照时,证件需摆正,护照四边要显示在图片中。
    5.OCR识别后,先点击“提交信息”按钮后,再将带有NFC功能的手机放置在证件上进行NFC读取,NFC读取的中途不能将手机拿走。
    -

羽山数据助力企业数字化