跳至主内容

prod

New

9:30-17:30

des

合规提示:

•使用数据服务的场景应当合理合规,如涉及个人隐私或商业机密,请您确保获得当事人的授权。

•在KYC场景中,推荐搭配使用身份证核验(IDV034)护照核验(PCB608)人脸比对核验(IVG000)等服务,确保实人认证授权。

•在KYB场景中,推荐搭配使用企业四要素认证(COM101)企业打款认证(COM084)法人短信认证(CLC001)等服务,确保企业认证授权。

•如需了解更多授权核验类产品请咨询您的专属客服~
  • -

    产品特点

    -

    •实时性强


    可实时获取证件状态,无缓存延迟,每次查询都能得到最新数据,让用户及时掌握证件的动态变化,有效避免因使用过期信息而产生的风险。


    •信息全面细致


    不仅返回证件的基本状态(如正常、已挂失、已注销等),为业务决策提供更丰富的数据支持。

  • -

    应用场景

    -

    •金融领域


    在银行开户、贷款审批、保险理赔等环节,用于核实客户身份及相关证件有效性,防止身份欺诈,保障金融交易安全。如贷款审批时,确认借款人身份证未挂失、驾驶证符合准驾要求,营业执照正常经营,降低违约风险。


    •电商平台


    商家入驻审核阶段,查验商家营业执照、法人身份证等证件状态,确保入驻商家合法合规经营,营造良好平台交易环境;用户实名认证时,核实用户身份证状态,保障用户账户安全。


    •人力资源管理


    企业招聘环节,对求职者提供的学历证书、职业资格证书、身份证等证件进行状态核实,防止虚假证件入职,提高招聘质量;在职员工证件管理,实时掌握员工相关证件有效期及状态变化,提前安排培训、换证等工作。

  • -

    覆盖体量

    -

    全国覆盖
  • -

    产品标签

    -

    证件状态查询、实时精准

出入参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明
name
姓名
cardNo
身份证号
validdate
身份证有效期开始时间
invaliddate
身份证有效期结束时间
分类 : 返回字段
名称说明
isNewest
证件是否最新
isLosted
证件是否挂失
isExpired
证件是否过期
hjzt
户籍状态

羽山数据API产品接入信息

报表设置

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

    结果示例

    -

    {
    "response_sn": "20250424*****Q",
    "retdata": {
    "isLosted": "0",
    "isNewest": "1",
    "hjzt": "0",
    "isExpired": "0"
    },
    "version": "1.0",
    "request_sn": "jHPnXRwMJkH**szWAz",
    "retmsg": "交易成功",
    "retdate": 174547**5,
    "retcode": "000000"
    }

羽山数据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": "IDV045",
"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 系统代码。
技术支持
400-110-8298
分类 : 2.加解密方法
名称说明
私钥
登录系统或联系技术支持获得接入KEY,
加密JSON Request 和解密response密文时需要使用。
注意要严格保密使用,请勿外泄,如有遗失,自行负责!
请求报文加密算法
将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交.
接收报文解密算法
将response JSON使用base64解码后,aes-128-cbc解密为明文.
分类 : 公共参数
名称说明
request_sn
请求序列号
acct_id
账号
prod_id
产品ID
req_data
传入参数
req_time
请求时间
response_sn
返回单号
retdata
返回参数
retcode
返回代码
retmsg
返回信息
retdate
返回时间戳