跳至主内容

prod

港澳台居民居住证识别

港澳台居民居住证识别API (IDV046)


支持对港澳居民居住证、台湾居民居住证的正、反面全字段识别，包括姓名、性别、身份证号码、通行证号码等，同时可返回头像切片位置信息，进行头像检测。

New

400-110-8298
9:30-17:30
bd@yushanshuju.com

des

合规提示：

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

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

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

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

    产品特点

    -

    •覆盖多类居住证


    支持港澳居民居住证、台湾居民居住证的正、反面识别，适配多类证件场景需求。




    •全字段精准提取


    可提取姓名、性别、身份证号码、通行证号码等正反面全字段信息，满足信息采集需求。




    •头像信息同步处理


    同步返回头像切片位置信息，并支持头像检测，实现证件信息与头像数据的一体化提取。

  • -

    应用场景

    -

    •政务服务办理


    线上线下办理港澳、台湾居民相关政务业务时，快速识别居住证信息并提取字段，简化资料录入流程，提升办事效率。




    •金融业务开户


    银行、支付机构为港澳、台湾居民办理开户等业务时，通过居住证识别完成身份核验，确保信息准确合规。




    •酒店入住登记


    酒店前台登记时，快速识别居住证正反面信息及头像，实现访客信息快速录入与核验，缩短办理时间。




    •教育机构入学


    学校、培训机构接收港澳、台湾学生时，通过居住证识别提取身份信息，辅助完成入学登记与档案建立。

  • -

    覆盖体量

    -

    港澳台居住证
  • -

    产品标签

    -

    证件识别、OCR

出入参数

羽山数据API产品详细介绍

分类 : 输入字段
名称说明
image
证件图片base64编码
分类 : 返回字段
名称说明
type
证件类型
image_angle
图片角度
rotated_image_width
正方向时图片的宽
rotated_image_height
正方向时图片高
item_list
父节点
key
item_list的子节点
value
item_list的子节点
description
item_list的子节点
position
item_list的子节点

羽山数据API产品接入信息

报表设置

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

    结果示例

    -

    {
    "trade_id": "2025072***KQ",
    "retdata": {
    "rotated_image_width": **3,
    "item_list": [{
    "confidence": 0.999***256,
    "description": "姓名",
    "position": [90, 54, 133, 54, 133, 71, 90, 71],
    "value": "陈**",
    "key": "name"
    }, {
    "confidence": 0.99****58,
    "description": "性别",
    "position": [92, 83, 105, 83, 105, 100, 92, 100],
    "value": "女",
    "key": "sex"
    }, {
    "confidence": 0.999,
    "description": "出生",
    "position": [],
    "value": "1***年**月5日",
    "key": "birth"
    }, {
    "confidence": 0.996***36,
    "description": "地址",
    "position": [90, 142, 258, 142, 258, 159, 90, 159],
    "value": "上海市***1号",
    "key": "address"
    }, {
    "confidence": 0.995***852,
    "description": "身份证号码",
    "position": [149, 223, 325, 223, 325, 238, 149, 238],
    "value": "71******27",
    "key": "id_number"
    }, {
    "description": "有效期限",
    "position": [],
    "value": "",
    "key": "validate_date"
    }, {
    "description": "签发机构",
    "position": [],
    "value": "",
    "key": "issue_authority"
    }, {
    "description": "签发次数",
    "position": [],
    "value": "",
    "key": "issue_number"
    }, {
    "description": "通行证号码",
    "position": [],
    "value": "",
    "key": "passnumber"
    }, {
    "description": "头像",
    "position": [],
    "value": "/9j/4AAQ*****",
    "key": "crop_image"
    }],
    "image_angle": 0,
    "type": "hkm****rmit",
    "rotated_image_height": 2**
    },
    "retmsg": "交易成功"
    }

羽山数据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": "IDV046",  
 "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
返回时间戳

API推荐

公司新闻  隐私政策  沪ICP备19015600号-1  Copyright © 2018-2019 羽山数据 格兰德上海 版权所有   监督电话：400-110-8298