# 识蛛云服务 Java SDK

普通Java sdk，未使用http连接池

# 下载 SDK

下载地址

# 添加到本地仓库

如果是非maven形式项目，直接将jar包放入Dependencies依赖目录

如果是maven项目，可在终端窗口执行以下命令安装到本地仓库：

Linux & Mac:

mvn install:install-file -Dfile=jar文件绝对路径 \
 -DgroupId=cn.unitid.realidentity \
 -DartifactId=openapi-java-sdk \
 -Dversion=版本号 \
 -Dpackaging=jar

mvn install:install-file -Dfile=jar文件绝对路径 \
 -DgroupId=cn.unitid.easypki \
 -DartifactId=jce \
 -Dversion=1.0.1-RELEASE \
 -Dpackaging=jar

Windows:

mvn install:install-file -Dfile=jar文件绝对路径  -DgroupId=cn.unitid.realidentity  -DartifactId=openapi-java-sdk  -Dversion=版本号 -Dpackaging=jar

mvn install:install-file -Dfile=jar文件绝对路径  -DgroupId=cn.unitid.easypki  -DartifactId=jce  -Dversion=1.0.1-RELEASE -Dpackaging=jar

然后在Maven项目pom文件中添加依赖：

  <dependency>
    <groupId>cn.unitid.realidentity</groupId>
    <artifactId>openapi-java-sdk</artifactId>
    <version>版本号</version>
  </dependency>

    <!-- 发证生成P10需要如下依赖 -->
   <dependency>
      <groupId>cn.unitid.easypki</groupId>
      <artifactId>jce</artifactId>
      <version>1.0.1-RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.bouncycastle</groupId>
        <artifactId>bcprov-jdk15on</artifactId>
        <version>1.61</version>
    </dependency>
    <dependency>
        <groupId>org.bouncycastle</groupId>
        <artifactId>bcmail-jdk15on</artifactId>
        <version>1.60</version>
    </dependency>
    <dependency>
        <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.14</version>
    </dependency>
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.6</version>
    </dependency>

# 开启关闭sdk错误日志

//开启日志
ApiLogger.setNeedEnableLogger(true);
//关闭日志
ApiLogger.setNeedEnableLogger(false);

# 身份证件号码15位支持

由于核验中心只支持二代身份证件核验因此对于旧有的15位证件号码需要根据规则转换为18位使用

以下示例以java版本SDK（v1.8.1开始支持）：

方法1. 全局开启15位证件号码转换

DefaultApiClient.enabledIdcard15To18();

方法2. 手动使用15位证件号码转换工具类（推荐）

String idcard15 = "15位证件号码";
String idcard18 = Utils.transformIdcard15to18(idcard15);

# SDK 版本变动记录

# 2023-10-24 （1.18.0）

该版本升级内容

实人认证时间戳/数字证书服务API增加属性score3,具体属性区间见api文档

下载该版本sdk

# 2023-02-16 （1.17.0）

该版本升级内容

请求参数:

手机号实名核验请求参数 realname、idcard、phone 支持加密
银行卡四元素核验请求参数 realname、idcard、phone、bankcard 支持加密
企业四要素核验请求参数 idcard 支持加密
H5活体实名核验-H5活体实名核验请求参数 attr.realname、attr.idcard 支持加密
视频活体实名核验请求参数 realname、idcard、videoData 支持加密
实名身份时间戳/数字证书服务API请求参数 realname、idcard 支持加密
实人认证时间戳/数字证书服务API请求参数 realname、idcard、image 支持加密
OCR识别服务请求参数image支持加密

响应参数:

OCR识别服务响应参数info支持加密

其他:

依赖包 cn.unitid.easypki.jce 升级为 1.0.16-SNAPSHOT,请注意更新依赖
增加SM4加解密工具类： Sm4Utils、SecretGenerateUtils

下载该版本sdk

# 2022-11-22 （1.16.0）

该版本升级内容

添加公共请求参数encMethod

下载该版本sdk

# 2021-12-31 （1.15.0）

该版本升级内容

实人认证时间戳/数字证书服务API增加属性score2,score属性区间改变为score2的区间,具体属性区间见api文档

// 代码修改示例: score 分数判定改完 0.6
        IdcardDetectionFaceRequest req = new IdcardDetectionFaceRequest();
        // ... 
        IdcardDetectionFaceResponse response = apiClient.execute(req);
        if (response.isSuccess() && null != response.getData()) {
            IdcardDetectionFaceResponse.Result data = response.getData();
            // incorrect 等于 100,比对成功,后续判断分数是否为同一人
            if (data.getIncorrect() == 100) {
                // sdk 版本 1.15.0 前(不包含1.15.0)
//                    if (data.getScore() >= 0.45) {
//                        // todo 系统判断为一人
//                    }

                // sdk 版本 1.15.0及以上, score 与score2一致,变更为0.6以上为同一人
                if (data.getScore() >= 0.6) {
                    // todo 系统判断为一人
                }
            }
        }

下载该版本sdk

# 2021-10-15 （1.14.0）

该版本升级内容

添加企业打款认证接口和相关测试方法，文档
H5活体实名核验获取认证会话接口attr修改为必填

下载该版本sdk

# 2021-02-01 （1.13.0）

该版本升级内容

优化核验相关API的事件证书支持

下载该版本sdk

# 2020-08-14 （1.12.0）

该版本升级内容

添加移动端在线活体验证接口和相关测试方法，文档

下载该版本sdk

# 2020-04-17 （1.11.0）

该版本升级内容

基础文档-》API错误码说明：添加身份未认证等四个返回码
添加企业，个人发证六个接口和相关测试方法，文档

下载该版本sdk

# 2019-12-30 （1.10.1）

该版本升级内容

添加企业四要素核验接口和相关测试方法，文档

下载该版本sdk

# 2019-12-27 （1.10.0）

该版本升级内容

OCR识别支持单张正反面
添加企业三要素核验接口和相关测试方法，文档
添加企业工商基础信息接口和相关测试方法，文档
添加企业工商信息接口和相关测试方法，文档
添加企业工商详细信息接口和相关测试方法，文档
添加企业信息列表接口和相关测试方法，文档

下载该版本sdk

# 2019-08-05 （1.9.0）

该版本升级内容

添加可信时间戳接口和相关测试方法，文档
添加可信事件证书和相关测试方法，文档
新增时间戳和事件证书相关参数说明

# 2019-06-12 （1.8.1）

该版本升级内容

添加15位证件号码转换功能

# 2019-04-30 （1.8.0）

该版本升级内容

ocr识别添加是否返回人脸截图

# 2019-04-15 （1.7.0）

该版本升级内容

添加银行卡四元素核验接口，相关测试方法，文档
人脸比对返回码添加详细说明
文档返回码添加收费说明

# 2019-03-08 （1.6.0）

该版本升级内容

添加人脸图片比对接口，相关测试方法，文档
静态活体认证至少上传两张图片
视频活体实名核验：返回码130描述，由“视频活体检测成功，未进行身份核验，人脸比对失败”改为“视频活体检测成功，照片质量不合格，未进行人脸比对”

# 2019-01-31 （1.5.0）

该版本升级内容

添加身份多项核验、人脸图片裁剪接口，相关测试方法，文档

# 2018-12-24 （1.4.6）

该版本升级内容

添加h5视频检测相关接口，测试方法，文档
修复静态活体认证返回值List为空问题解决

# 2018-12-13 （1.4.5）

该版本升级内容

返回值List为空问题解决

# 2018-12-12 （1.4.4）

该版本升级内容

添加自动重试客户端，修改相关测试方法，文档
视频vedio改成video接口和相关测试方法，文档修改

# 2018-11-21 （1.4.0）

该版本升级内容

静态活体认证接口上传图片类型url:替换为fs:，修改相关测试方法，文档
添加获取文件上传权限接口和相关测试方法，文档
添加下载应用账单接口和相关测试方法，文档
添加视频活体实名认证接口和相关测试方法，文档
添加视频活体检测接口和相关测试方法，文档
添加OCR图片识别接口和相关测试方法，文档
添加图片处理测试方法
去除控件活体检测IdcardLiveness，该方法已经下架
人脸比对返回码修改

# 2018-09-27 （1.3.2）

该版本升级内容

修复去除\n字符导致的问题

# 2018-09-19 （1.3.1）

该版本升级内容

添加图片BASE64字符串时去除\n字符

# 2018-09-13 （1.3.0）

该版本升级内容

添加静态活体认证接口和相关测试方法，文档
人脸比对添加非必填字段，质量控制，修改相应方法，文档

# 2018-08-01（1.2.0）

该版本升级内容:

人脸识别添加scoreMsg(分数建议)，返回码添加102，107，108

# 2018-06-08（1.1.1）

该版本升级内容:

响应参添加状态码incorrect，修改相应文档
添加账户余额查询接口

# 2018-06-07（1.0.3）

该版本升级内容:

活体检测添加非必填参数isH5，修改测试用例

# 2018-04-23（1.0.2）

该版本升级内容:

API调用协议：响应参数添加requestId做唯一标识，错误码解释添加10016
修改说明文档，去除获取身份证返照接口

# 2018-03-02（1.0.1）

该版本升级内容:

添加说明文档
修改系统错误提示

← 介绍 PKI云服务 Java SDK →