# 识蛛云服务 Java SDK

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

# 下载 SDK

下载地址

点击立即下载实名认证 Java 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)

该版本升级内容

请求参数:

响应参数:

其他:

  • 依赖包 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)

该版本升级内容:

  • 添加说明文档
  • 修改系统错误提示
最后更新于: 10/24/2023, 4:40:14 PM