本文档主要面向于API开发者群体，阐述了翔云提供的接口服务的各项技术要点。如您在阅读过程中对文档内容存有任何疑问或不解之处，我们提供了多种联系方式供您随时咨询反馈：
手机号：13810080484
邮箱：info@sinosecu.com.cn
在线咨询：微信13810080484、QQ 3456221053
1、版权说明
未经翔云网站授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述
（1）文字识别类服务API主要实现了以下功能：
- 通过https协议post方法上传各种证、照彩色图像文件（身份证、护照、票据、文本、银行卡、驾照、营业执照、车牌、人脸等）通过https接口进行识别；
- 将识别结果以XML或json格式返回给用户；
（2）查验类服务API主要实现了以下功能：
- 通过https协议post方法上传指定参数或图片，通过https接口进行核验；
- 将核验结果以json格式返回给用户；
（3）接口支持服务类型及概述：
| 产品名称 | 功能概述 |
|---|---|
| 证件识别 | 可识别身份证、行驶证、驾驶证、护照、港澳通行证等80多种海内外证件 |
| 车牌识别 | 可识别普通蓝牌、普通黄牌(单层)、双层黄牌、新能源车牌、军牌、武警车牌、使馆车牌、农用车牌等各种规格汽车号牌 |
| 名片识别 | 识别各种名片，包含横版名片、竖版名片，并支持各种复杂背景名片的识别 |
| 银行卡识别 | 识别各种银行卡，包含平面字体银行卡、凸面字体银行卡，支持对普通横版银行卡、竖卡、异形卡的识别 |
| 人脸识别 | 对两张人脸图像进行识别比对，判断是否为同一个人的人脸 |
| 视频活体检测 | 对上传的视频进行检测，确认视频中人物是否为真人，检测为真人，则返回一张人脸照片用于下一步比对验证 |
| 静默活体检测 | 对上传的人脸图像进行检测，确认图像中人脸是否为人体实时拍摄，能够防止照片攻击、面具攻击、屏幕攻击等行为 |
| 文档识别 | 识别扫描文档、长微博、自然场景下的印刷简体、繁体，手写体文字的识别 |
| 人证合一 | 可识别身份证信息，并对身份证上的头像人脸与现场人脸进行识别比对，从而判断持证人是否为身份证所有人在使用 |
| 营业执照识别 | 可识别营业执照上的全部字段信息，支持三证合一版营业执照和五证合一版营业执照 |
| 发票识别 | 可识别增值税发票、财政类票据、数电票、纸电票等票据，支持全票种自动分类识别：一图多票、PDF多页识别、OFD格式识别 |
| VIN码识别 | 可快速精准定位上传的图片中VIN码区域并进行文字识别，返回VIN号码 |
| 房产证识别 | 可识别多种类型的房产证，对房产证上的关键字段进行识别并结构化输出 |
| 不动产证识别 | 可识别多种类型的不动产权证明，对证件上的关键字段进行识别并结构化输出 |
| 车辆合格证识别 | 可识别车辆合格证中文字信息，包括编号、车辆品牌、车架号、发动机型号、发动机号、燃料种类、排放标准、货厢内部尺寸等信息 |
| 承兑汇票识别 | 可自动、批量识别承兑汇票的票面信息，包括出票日期、出票人账号、收款人账号、大写金额等信息 |
| 银行回单识别 | 支持国内各大银行的电子及纸质回单的收款人名称、付款人账号、收款人账号、大小写金额等关键信息的文字识别 |
| 印章识别 | 支持圆形章、椭圆形章、合同专用章、发票专用章等常见印章的检测，对印章文字内容进行识别 |
| 报关单识别 | 可识别进、出口报关单，结构化输出字段信息，可根据字段坐标进行版面还原 |
| 通用表格识别 | 可识别各种表格类图像、PDF文件的文字信息，可根据字段坐标进行版面还原 |
| 发票验真 （增值税发票） |
可根据发票要素信息对增值税系统开具的全票种发票进行查验，查验一致则返回发票的全票面信息 |
| 财政票据查验 | 可根据发票要素信息对财政电子票据进行查验，非税收入、电子医疗等票据可返回明细信息 |
| 身份证号实名认证 | 公安一所实时数据，快速核查身份证姓名和号码是否一致 |
| 身份证实名认证 | 核验提供的姓名和身份证号码是否与权威数据库中匹配，同时，核验上传的身份证图片中人像与权威数据库中人像相似度，返回人像比对相似度百分比值 |
| 身份实名认证 | 公安一所实时数据，核验提供的姓名和身份证号码是否匹配，返回是否一致的结果，同时，核验人像与公安一所库中人像相似度，返回人像比对相似度百分比值 |
| 手机号实名认证 | 三大运营商（移动、联通、电信）实时数据，快速核查上传姓名+身份证号+手机号是否一直 |
| 银行卡实名认证 | 银联实时数据，快速核查上传银行卡、姓名、身份证号、手机号是否一致 |
| 企业工商信息查询 | 通过企业（个体）名称、企业信用代码查询工商信息。返回的字段包含企业及个体营业执照照面信息、经营状态、曾用名、股东等信息，数据覆盖全国 |
| 护照查验 | 对接权威数据源实时数据，可查询出入境管理局签发护照（港澳台通行证）的姓名+证件号码+人像是否一致 |
| 永居证查验 | 对接权威数据源实时数据，可查询外国人永久居留证的姓名+身份证号+人像是否一致 |
4、服务调用约束
在调用文字识别接口和认证查验接口之前，请您确保客户端程序或设备网络连接通畅。
（1）关于http/https的选用
为保证数据在传输过程中的安全性,防止数据在交互时被窃取、监听,保证交互的稳定性,我们推荐您使用https协议来进行接口调用。
（2）对识别图像的要求
- 图像文字清晰，人眼可辨别；
- 对比度、亮度适中；
- 尽量不要有背景，即证件充满图片，如果不能保证没有背景，请选择纯黑背景而且背景不宜过多。
- 图像在200-300kb左右最佳，不能超过10M，否则会返回超时，文件越大，返回结果的速度越慢。
（3）对扫描图像的要求
扫描时选择分辨率300dpi，不能低于150 dpi，分辨率最好不要过高，否则识别速度会很慢。
（4）对拍摄图像/视频的要求
- 拍摄时注意光照的影响，尽量避免反光和黑影，尤其是证件有薄膜覆盖的时候；
- 拍摄时做好聚焦，以免影像模糊不清；
- 拍摄时将证件、文档、人脸放正；
- 尽量不要使拍摄角度倾斜过大，以免造成图像变形；
- 拍摄时请不要选择过高的分辨率拍摄，一方面造成图片过大，不利于传输，一方面分辨率过高也会影响识别率。拍摄时可以选择1280*960分辨率拍摄，低一些的分辨率也可以选择，但是要确保图像文字清晰。视频文件大小不要超过1M。