实名服务接口说明

1 概述

前提条件：第三方应用在天威诚信电子认证云服务平台（简称天威云）进行应用注册，获得应用标识和应用密钥。 异常相应结果参数及格式如下： status：状态码，1表示成功； 0表示失败； message：对调用失败原因的描述；

2 前提条件

第三方应用在天威诚信电子认证云服务平台进行应用注册，获得应用标识和应用密钥。

3 通用约束

● 所有请求内容类型默认使用application/x-www-form-urlencoded； ● 所有涉及到编码的环节一律采用UTF-8（例如URLEncoding、String转byte[]等）； ● 当接口参数为二进制字节数组时，一律Base64编码后再传递； ● 所有图片数据限制在2M以内；

4 安全性设计

● 通讯安全 采用SSL安全连接，防止信息篡改、中间人窃听和重放攻击； ● 访问安全 请求中请求方必须带Content-Signature签名值，签名的内容为请求参数，签名密钥为应用密钥，确保信息的不被篡改。

代码示例:

    org.eclipse.jetty.client.api.Request request = jettyhttpclient.POST(url)

    .header("Content-Signature", "HMAC-SHA1 " + signature)

    .content(new BytesContentProvider(byterequest), "application/json;charset=UTF-8");

HttpUtil类文件下载

5 服务接口定义

5.1 个人实名认证

个人实名失败特殊事项说明：

一、传入的身份证号有误，或者有空格等；

二、个人实名次数一天内超过10次（为保护个人信息，限制24小时同一个用户只能实名10次，防止试探用户身份信息）

三、如核实身份号传入没问题，可能的原因有 （1）做过户口迁移，新迁入的户籍信息，系统数据尚未更新； （2）现役军人， 系统没有存储军人信息； （3）刚退役的军人，新办理的户口及身份证还未更新到系统； （4）刚上大学或者刚毕业的大学生，迁移了户口，信息还未更新。 （5）身份证过期未办理，或新办理的身份证数据库还未更新。 （6）不实的身份证信息

身份证信息更新滞后是由于各个地方公安同步数据的时间问题，一直没有更新到中心，因为同步的环节较多，是县---->市---->省---->部里--→中心

关于港澳台同胞身份的认证建议灵活处理，比如如果在内地有办理手机号，那么可以采用手机三要素；有办理内地银行卡可以采用银行卡四要素等

5.1.1 个人实名综合申请接口

请求参数：

返回值：

正常调用示例：

x

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 个人实名认证综合接口

    public static void idenAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = null;

        String bankcard = "null;

        String mobile = "null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("bankcard", bankcard);

        params.put("mobile", mobile);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1

                .getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

    public static void main(String[] args) throws Exception {

        idenAuth();//个人实名认证综合接口

    }

}            

正常返回示例：

xxxxxxxxxx

{

    "message": "二要素比对成功。",

    "status": "1",

    "orderNumber": "YYCSidc201810291455302175022"

}          

5.1.1.1 身份证简项

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 个人实名认证综合接口——身份证简项认证方式

    public static void idenAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = null;

        String bankcard = null;

        String mobile = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1

                .getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

}            

正常返回示例：

xxxxxxxxxx

{

    "message": "二要素比对成功。",

    "status": "1",

    "orderNumber": "YYCSidc201810291455302175022",

}          

错误返回示例：

xxxxxxxxxx

{

    "status": 100002,

    "message": "提交的参数不完整或格式不正确"

}          

5.1.1.2 身份证人像核验

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test { // 个人实名认证综合接口——身份证人像核验方式

    public static void portraitAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = "/9j/4AAQSkZJRgABAQEASABIA******";

        String bankcard = null;

        String mobile = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("selfImg", selfImg);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1

                .getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

}                           

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "confidence":93.0%,

    "message":"人像比对成功",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":103013,

    "confidence":3.0%,

    "message": "相似度比对未通过"，

    "orderNumber": " idc2020011414265759110**"

}

5.1.1.3 银行卡三要素

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //  个人实名认证综合接口——银行卡三要素认证方式

    public static void bankAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = null;

        String bankcard = "6227******";

        String mobile = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("bankcard", bankcard);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

}            

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"银行卡比对成功",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message": "提交的参数不完整或格式不正确"

}

5.1.1.4 银行卡四要素

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //  个人实名认证综合接口——银行卡四要素认证方式

    public static void banksAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = null;

        String bankcard = "6227******";

        String mobile = "1531******";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("bankcard", bankcard);

        params.put("mobile", mobile);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

}            

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"银行卡比对成功",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message":"提交的参数不完整或格式不正确"

}

5.1.1.5银行卡五要素

请求头参数：

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //银行卡五要素认证

    public static void bankCardFiveAuth() throws Exception {

        String appId = APP_ID;

        //产品编码

        String serviceCode = "idc0009";

        //姓名

        String name = "李**";

        //身份证号

        String idCard = "411503********8739";

        //银行卡号

        String bankcard = "622588****098754";

        //手机号

        String mobile = "153****2145";

        //账户类型

        String accountType = "1";

        Map<String, Object> params = new HashMap<String, Object>(8);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("idCard", idCard);

        params.put("name", name);

        params.put("accountType", accountType);

        params.put("bankcard", bankcard);

        params.put("mobile", mobile);

        Map<String, String> headers = new HashMap<>(8);

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonBankCardFiveAuth(params), SECRET_KEY)));

        String response = HttpUtil.doPost(URL + "/person/bankCardFiveElements", params, headers);

        System.out.println(response);

    }

    //必须按照以下顺序依次获取map键所对应的值

    private static String getPersonBankCardFiveAuth(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode") + params.get("name") + params.get("idCard") + params.get("bankcard") + params.get("mobile") + params.get("accountType");

        System.out.println(ss);

        return ss;

    }

}  

正确返回示例：

xxxxxxxxxx

{

    "orderNumber":"idc202104231941283113028",

    "message":"不匹配",

    "status":106010

}

5.1.1.6手机号三要素

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

     import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //  个人实名认证综合接口——手机号三要素认证方式

    public static void idenAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String selfUrl = null;

        String selfImg = null;

        String bankcard = null;

        String mobile = "138******";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("mobile", mobile);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idCard + selfUrl + selfImg + bankcard + mobile, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/person/authIden", params, headers);

        System.out.println(response);

    }

}      

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"手机三要素比对成功",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message": "提交的参数不完整或格式不正确"

}

5.1.1.7银行卡四要素(境外)

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    public static void idenAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String name = "张三";

        String idCard = "2******";

        String bankcard = 62 ***1;

        String mobile = "138******";

        String idtype = "01";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("mobile", mobile);

        params.put("idtype", idtype);

        String jsonBody = JSON.toJSONString(params);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("appId", appId);

        headers.put("serviceCode", serviceCode);

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(jsonBody, SECRET_KEY + serviceCode)));

        String response = HttpUtil.doPostJson("http://******:**/apigate/authapi" + "/person/bankCardFourElementsOverseas", jsonBody, headers);

        System.out.println(response);

    }

}        

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"银行卡四要素(境外)比对成功",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "orderNumber": "idc202111291732133298236",

    "message": "认证信息不匹配,与银行卡预留信息不一致",

    "status": 108010

}

5.1.2 H5数读活体人脸验证接口

【H5获取唇语数字】

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //H5获取唇语

    public static void h5Auth() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc2008";

        String name = "晶";

        String idnumber = "612429199001121316";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idnumber", idnumber);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idnumber, SECRET_KEY)));

        String response = HttpUtil.doPost(URL + "/h5/getlips", params, headers);

        System.out.println(response);

    }

}   

正常返回示例：

xxxxxxxxxx

{

    "status": 1,

    "message": "成功",

    "lips": "3520",

    "orderNo": "idc2019032810453803858**"

}        

错误返回示例：

xxxxxxxxxx

{

    "status": 100005,

    "message": "服务密钥错误"

}        

【H5活体人脸验证】

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //H5活体校验

    public static void h5portraitAuth() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc2009";

        String name = "兴";

        String idnumber = "131024198801150912";

        String orderNo = "";

        String videoFile = Img2Base64Util.getImgStr("d:\\a93cf6abdb2387bbeeafe05886909560.mp4");

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idnumber", idnumber);

        params.put("orderNo", orderNo);

        params.put("videoFile", videoFile);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idnumber + orderNo + videoFile, SECRET_KEY)));

        String response = HttpUtil.doPost(URL + "/h5/bodyFaceCheck", params, headers);

        System.out.println(response);

    }

}   

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"校验成功",

    "confidence":"75.0",

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":2,

    "message":"相似度太低",

    "confidence":"0.0",

    "orderNumber":"idc2020011510035834260**"

}

5.1.3 H5静默/活体人脸验证接口

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    //H5活体校验  

    public static void h5portraitAuth() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc2009";

        String name = "兴";

        String idnumber = "131024198801150912";

        String orderNo = "";

        String videoFile = Img2Base64Util.getImgStr("d:\\a93cf6abdb2387bbeeafe05886909560.mp4");

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idnumber", idnumber);

        params.put("orderNo", orderNo);

        params.put("videoFile", videoFile);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + name + idnumber + orderNo + videoFile, SECRET_KEY)));

        String response = HttpUtil.doPost(URL + "/h5/bodyFaceCheck", params, headers);

        System.out.println(response);

    }

}

正常返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"校验成功",

    "confidence":"75.0",

    "orderNo":"idc2020011414265759110**",

    "faceImage":"base64编码图片"

}

错误返回示例：

xxxxxxxxxx

{

    "status":2,

    "message":"相似度太低",

    "confidence":"0.0",

    "orderNo":"idc2020011414265759110**"

}

5.1.4身份证OCR-API

请求参数：

返回值：

【JSON格式字符串】

info具体返回信息格式

xxxxxxxxxx

身份证正面：

{

   "number":"身份证号",

   "address":"地址",

   "gender":"性别",

   "month":"出生月",

   "nation":"民族",

   "year":"出生年",

   "name":"姓名",

   "day":"出生日"

}

身份证反面：

{

   "authority":"签发机关",

   "timelimit":"身份证有效期"

}

正常调用示例：

xxxxxxxxxx

public class OcrTest {

    private static final String URL = "http://open.itruscloud.com/apigate";

    private static final String APP_ID = "488**********41";

    private static final String SECRET_KEY = "e1fa6e*******************20214f9";

    //身份证ocr验证--正面

    public static void idCardFort() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc1004";

        String base64File = Img2Base64Util.getImgStr("D:\\img\\wxh.png");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("base64File", base64File);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/authapi/image/ocrCheck", params, headers);

        System.out.println(response);

    }

    //身份证ocr验证--反面

    public static void idCardBank() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc1004";

        String base64File = Img2Base64Util.getImgStr("D:\\img\\yt1.jpg");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("base64File", base64File);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/authapi/image/ocrCheck", params, headers);

        System.out.println(response);

    }

}

正常返回示例：

xxxxxxxxxx

身份证正面：

{

  "orderNo":"idc201907171019104122154",

  "message":"身份证OCR验证成功",

  "status":1,

  "info":"{"number":"36233***********3094","address":"江西省上饶市鄱阳县谢家滩镇陈七村009号","gender":"男","month":"6","nation":"汉","year":"1996","name":"陈**","day":"5"}"

}

身份证反面：

{

  "orderNo":"idc201907171021433926475",

  "message":"身份证OCR验证成功",

  "status":1,

  "info":"{"authority":"上海市公安局闵行分局","timelimit":"20060307-20260307"}"

}

5.1.5银行卡OCR-API

请求参数：

返回值：

【JSON格式字符串】

info具体返回信息格式

xxxxxxxxxx

{

    "bank_identification_number": "发卡行标识代码",

    "card_number": "银行卡号",

    "bank_name": "发卡行名称",

    "card_name": "卡片名称",

    "card_type": "卡片类型(注：支持借记卡，贷记卡，准贷记卡及预付费卡类型的 识别)"

}

正常调用示例：

xxxxxxxxxx

public class OcrTest {

    private static final String URL = "http://open.itruscloud.com/apigate";

    private static final String APP_ID = "488**********41";

    private static final String SECRET_KEY = "e1fa6e*******************20214f9";

    //银行卡ocr验证

    public static void bankCard() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc1005";

        String base64File = Img2Base64Util.getImgStr("D:\\img\\gs.jpg");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("base64File", base64File);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/authapi/image/bankcardCheck", params, headers);

        System.out.println(response);

    }

}                  

正常返回示例：

xxxxxxxxxx

{

    "orderNo": "idc201907171022497041720",

    "message": "银行卡OCR验证成功",

    "status": 1,

    "info": "{"bank_identification_number":"01030000","card_number":"9559980210373015416","bank_name":"农业银行","card_name":"借记卡(银联卡)","card_type":"借记卡"}"

}

5.1.6人脸比对-API

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

public class FaceTest {

    private static final String URL = "http://open.itruscloud.com/apigate";

    private static final String APP_ID = "a929c*******e46";

    private static final String SECRET_KEY = "7d837a8f7b1********02cc94815b6db";

    //人脸比对

    public static void PersonFaceVerification() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc3001";

        String selfieImgUrl = null;

        String faceImgUrl = null;

        String selfieImg = Img2Base64Util.getImgStr("D:\\天威工作\\picture\\test01.jpg");

        String faceImg = Img2Base64Util.getImgStr("D:\\天威工作\\picture\\test01.jpg");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        // params.put("selfieImgUrl", selfieImgUrl);

        // params.put("faceImgUrl", faceImgUrl);

        params.put("selfieImg", selfieImg);

        params.put("faceImg", faceImg);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/authapi/image/personFace", params, headers);

        System.out.println(response);

    }

    // 必须按照以下顺序依次获取map键所对应的值

    private static String getPersonSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode") + params.get("faceImgUrl") + params.get("faceImg") + params.get("selfieImgUrl") + params.get("selfieImg");

        System.out.println(ss);

        return ss;

    }

    public static void main(String[] args) throws Exception {

        PersonFaceVerification();

    }

}                

正常返回示例：

xxxxxxxxxx

{

    "orderNumber": "idc201908281827056117848",

    "confidence": "80.00%",

    "message": "人脸比对成功 ",

    "status": 1

}

错误返回示例：

xxxxxxxxxx

{

    "orderNo": "idc202006231637542474228",

    "confidence": "60.2%",

    "message": "相似度太低",

    "status": 103013

}        

5.1.7驾驶证OCR-API

请求参数：

返回值：

具体返回信息格式

xxxxxxxxxx

{

    "info_negative": {

        "file_number": "",   //

        "record": "",

        "idcard": "",

        "name": "",

        "barcode": ""

    },

    "orderNo": "idc202101041825339297404",

    "info_Positive": {

        "birthday": "1992-06-03",

        "end_date": "2021-07-26",

        "address": "广东省河源市源城区红星路69号",

        "nationality": "中国",

        "firstGetDocDate": "2015-07-26",

        "sex": "男",

        "begin_date": "2015-07-26",

        "idcard": "4115031992xxxxxxxx",

        "name": "xxx",

        "type": "C1"

    },

    "message": "驾驶证扫描成功",

    "status": 1

}

正常调用示例：

xxxxxxxxxx

public class OcrTest {

    private static final String URL = "http://open.itruscloud.com/apigate";

    private static final String APP_ID = "488**********41";

    private static final String SECRET_KEY = "e1fa6e*******************20214f9";

    /**

     * 驾驶证OCR

     *

     * @throws Exception 异常

     */

    public static void drivingLicence() throws Exception {

        String appId = APP_ID;

        //产品编码

        String serviceCode = "ocr0001";

        //图片base64

        String base64File = Img2Base64Util.getImgStr("G:\\images\\微信图片_20201225172324.jpg");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("base64File", base64File);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/image/drivingLicenceOcr", params, headers);

        System.out.println(response);

    }

    //必须按照以下顺序依次获取map键所对应的值

    private static String getPersonSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode") + params.get("base64File");

        System.out.println(ss);

        return ss;

    }

}    

5.1.8驾驶证三要素

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

    // 驾驶证三要素认证

    public static void drivingLicenceVerify() {

        String appId = APP_ID;

        //产品编码

        String serviceCode = "idc0007";

        //姓名

        String name = "xxx";

        //身份证号

        String idCard = "411503xxxxxxxxxxxx";

        //手机号

        String recordId = "4416xxxx9305";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idCard", idCard);

        params.put("recordId", recordId);

        try {

            Map<String, String> headers = new HashMap<>();

            headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getDrivingSign(params), SECRET_KEY)));

            System.out.println(new Base64().encodeToString(HMACSHA1.getHmacSHA1(getPersonSign(params), SECRET_KEY)));

            String response = HttpUtil.doPost(URL + "/person/drivingLicenceVerify", params, headers);

            System.out.println(response);

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

    //必须按照以下顺序依次获取map键所对应的值

    private static String getDrivingSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode") + params.get("name") + params.get("idCard")

                + params.get("recordId");

        System.out.println(ss);

        return ss;

    }

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"驾驶证三要素核验成功",

    "score":"0"

    "orderNumber":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message": "提交的参数不完整或格式不正确"

}

5.1.9 H5眨眼活体验证接口

提示：未完成认证或认证结果已过期的可能原因

1.验证次数过多超限后被风控，风控后的订单为无效，查询结果为未完成认证或认证结果已过期 2.用户中途退出刷脸，没有完成人脸验证的流程，没有比对，查询结果为未完成认证或认证结果已过期 3.操作超时，请退出重试 ，验证时间须在5分钟内完成，失效后无法进入刷脸流程，查询结果为未完成认证或认证结果已过期 4.视频格式或大小不合法 文件或视频不合法，无法进行比对，查询结果为未完成认证或认证结果已过期 5.上传的视频非实时录制,被时间戳校验拦截，查询结果为未完成认证或认证结果已过期 6.查询超过3天的订单返回未完成认证或认证结果已过期 7.app调用H5眨眼需要参考下面做下兼容配置：https://cloud.tencent.com/document/product/1007/61076 

1. 如有IP白名单设置，需要放开地址：kyc.qcloud.com、miniprogram-kyc.tencentcloudapi.com、www.itruscloud.com、www.webank.com

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

   //H5眨眼活体校验

    public static void h5BlinkAuth() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idc2009";

        String name = "兴";

        String idnumber = "131024198801150912";

        String orderNo = "";

        String blinkUrl = "http://localhost:8084/authweb/public/blink/callBack";

        String fromType = "browser";

        String successLocation = "http://www.baidu.com";

        String failLocation = "http://www.baidu.com";

        Map<String, Object> params = new HashMap<>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("idnumber", idnumber);

        params.put("orderNo", orderNo);

        params.put("blinkUrl", URLEncoder.encode(blinkUrl,"UTF-8"));

        params.put("fromType", fromType);

        params.put("successLocation", successLocation);

        params.put("failLocation", failLocation);

        Map<String,String> headers=new HashMap<>(4);

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(getH5BlinkSign(params), SECRET_KEY)));

        String response=HttpUtil.doPost(URL+"/h5/blink", params, headers);

        System.out.println(response);

    }

    //H5眨眼认证秘钥计算规则

    private static String getH5BlinkSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode")

                 + params.get("name") + params.get("idnumber")

                 + params.get("blinkUrl") + params.get("fromType")

                 + params.get("successLocation") + params.get("failLocation");

        System.out.println(ss);

        return ss;

    }

正常返回示例：

xxxxxxxxxx

{

    "orderNo": "idc202103261045253536353",

    "loginUrl": "https://ida.webank.com/api/web/login?&orderNo=idc202103261045253536353&sign=3374d804464c62ca2bbb6448347c6ec327b046f0&from=null&webankAppId=TIDAm7wi&userId=tianwei0002&version=1.0.0&nonce=1c5aff0104b74b5c83a458955e38c217&h5faceId=d34c080a3296d7a462a42b71c8042d1b&url=http%3A%2F%2F192.168.101.35%3A8080",

    "message": "获取启用H5认证链接成功",

    "status": 1

}

错误返回示例：

xxxxxxxxxx

{

    "message": "姓名或身份证不合法",

    "status": 100002

}

5.1.10 回调用户接口说明

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

   //H5眨眼活体校验

    public static void h5BlinkAuth() throws Exception {

        HashMap<String, Object> param = new HashMap<>();

        param.put("status", 1);

        param.put("message", "认证成功");

        param.put("confidence", 90f);

        param.put("orderNo", "idc202103261045253536353");

        String response= HttpUtil.doPostJson(blinkUrl, JSON.toJSONString(param));

        System.out.println(response);

    }

正常返回示例：

xxxxxxxxxx

{

    "message": "认证成功",

    "code": 1

}

5.1.11 汽车违章信息查询

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

    // 汽车违章信息查询

    public static void trafic() {

        Map<String, Object> params = new HashMap<String, Object>(8);

        String serviceCode = "idc0010";

        params.put("appId", APP_ID);

        params.put("serviceCode", serviceCode);

        params.put("carNumber", "冀RG**22");

        params.put("carType", "02");

        params.put("carCode", "LFV3A23C*****9997");

        params.put("carEngine", "C4**50");

        try {

            Map<String, String> headers = new HashMap<>(4);

            headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getTrafficSign(params), SECRET_KEY)));

            String response = HttpUtil.doPost(URL + "/person/traffic", params, headers);

            System.out.println(response);

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

    //必须按照以下顺序依次获取map键所对应的值

    private static String getTrafficSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode")

            + params.get("carNumber") + params.get("carType")

            + params.get("carCode")+ params.get("carEngine");

        return ss;

    }

正常返回示例：

xxxxxxxxxx

{

    "orderNumber":"idc202106011753394399490",

    "status":1,

    "trafficInfo":{

        "fineTotal":"200",

        "times":"1",

        "info":[

            {

                "penaltyPoint":"3",

                "number":"12356",

                "reason":"机动车违反禁止标线指示的",

                "city":"江苏南京",

                "fines":"100",

                "location":"幸福路111",

                "time":"2019-01-01 00:00:00",

                "status":"0"

            }

        ],

        "integralTotal":"3"

    }

}

5.1.12 商汤数字签名验证接口

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

{

    "requestId":"e1b14e08395fb78cc896dbe362d4a34c",

    "passed":true,

    "message":"验证通过",

    "status":200,

    "timestamp":"1628049216783"

}

正常返回示例：

xxxxxxxxxx

{

    "requestId":"576f235fc333b6b0eff28755a5e850f1",

    "passed":false,

    "message":"验证不通过",

    "status":400,

    "timestamp":"1628056931402"

}

##

5.2企业实名认证

企业实名失败特殊事项说明：

一、同一企业24h内打款次数超过2次（为防止触发银行的反洗钱机制，防止用户往同一账户打款次数过多）；

二、预演环境企业实名认证相关接口中，如果涉及到法人信息认证的情况时，法人姓名带有"测试"字样时，会导致实名认证失败。

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 企业实名认证综合接口

    public static void licenseAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = null;

        String legalName = "赵**";

        String legalId = "3307211*******56916";

        String legalUrl = null;

        String legalImg = null;

        String agentName = "王**";

        String agentId = " 1407234*******09732 ";

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        params.put("legalName", legalName);

        params.put("legalId", legalId);

        params.put("agentName", agentName);

        params.put("agentId", agentId);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

}        

正常返回示例：

xxxxxxxxxx

//营业执照+法定代表人+代理人组合认证方式

{

    "enterpriseInfo": {

        "OperName": "徐海柱",

        "TeamEnd": "长期",

        "No": "440105000057604",

        "Name": "广东方向盘牛品牌策划设计有限公司",

        "Status": "在营（开业）",

        "EndDate": null,

        "CreditCode": "91440101661810975F",

        "StartDate": 1177344000000,

        "Address": "广州市海珠区广州大道南51号201室（仅限办公用途）",

        "RegistCapi": "(万人民币元)1001.000000",

        "BelongOrg": "广州市海珠区工商行政管理局",

        "EconKind": "有限责任公司(自然人投资或控股)",

        "CheckDate": 1473782400000,

        "TermStart": 1177344000000,

        "Scope": ""

    },

    "message": "企业基本信息比对成功。企业法人四要素比对成功。二要素比对成功。",

    "status": "1",

    "orderNumber": "yycsidb201811281458037749629"

}        

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message":"提交参数信息不完整或参数格式不正确",

}

5.2.1.1 企业工商信息核验

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

    public static void licenseAuth() throws Exception {

        String appId = APP_ID;

        //产品编码

        String serviceCode = "idb0003";

        //企业类型

        String type = "ET_PE";

        //企业名称

        String name = "北京天威诚信电子商务服务有限公司";

        //企业社会统一信用代码

        String idCode = "911101088020176153";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getEnterpriseSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));      

        String body = JSON.toJSONString(params);

        String response = HttpUtil.doPostJson(URL + "/enterprise/authIden", body, headers);

        System.out.println(response);

    }

 private static String getEnterpriseSign(Map<String, Object> params) {

        String ss = (String) params.get("appId") + params.get("serviceCode") + params.get("type") + params.get("name")

                + params.get("idCode") + params.get("orgCode") + params.get("legalName") + params.get("legalId") + params.get("legalUrl")

                + params.get("legalImg") + params.get("agentName") + params.get("agentId") + params.get("agentUrl") + params.get("agentImg");

        System.out.println(ss);

        return ss;

    }

正确返回示例：

xxxxxxxxxx

{

"status": 1,

"message": "企业基本信息比对成功。",

"enterpriseInfo": {

        "Status": "在营（开业）",

        "RegistCapi": "(万美元)4520.000000",

        "No": "110000410144104",

        "BelongOrg": "北京市工商行政管理局海淀分局",

        "CreditCode": "911101088020176153",

        "OperName": "张王李赵",

        "EconKind": "有限责任公司(外国法人独资)",

        "Address": "北京市某区某路某大厦666号",

        "Name": "赵县安林小卖部。",

        "TermStart": 948124800000,

        "StartDate": 948124800000,

        "TeamEnd": "1610812800000",

        "Scope": "开发、生产计算机软件；提供相关技术咨询、技术服务、技术培训；承接计算机网络系统工程；销售自产产品、医疗器械II类；货物进出口、技术进出口、代理进出口；设计、制作、代理、发布广告；软件开发；销售第三类医疗器械。（销售第三类医疗器械以及依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动。）",

        "CheckDate": 1549814400000

    },

"orderNo":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message":"提交参数信息不完整或参数格式不正确",

}

5.2.1.1 企业登记信息核验

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 企业实名认证综合接口——营业执照认证方式

    public static void licenseAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = null;

        String legalName = null;

        String legalId = null;

        String legalUrl = null;

        String legalImg = null;

        String agentName = null;

        String agentId = null;

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        Map<String, String> headers = new HashMap<>();

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

    // 企业实名认证综合接口——营业执照+组织机构代码认证方式

    public static void organizationAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = "******";

        String legalName = null;

        String legalId = null;

        String legalUrl = null;

        String legalImg = null;

        String agentName = null;

        String agentId = null;

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        params.put("orgCode", orgCode);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

}        

正确返回示例：

xxxxxxxxxx

{

"status": 1,

"message": "企业基本信息比对成功。",

"enterpriseInfo": {

        "Status": "在营（开业）",

        "RegistCapi": "(万美元)4520.000000",

        "No": "110000410144104",

        "BelongOrg": "北京市工商行政管理局海淀分局",

        "OperName": "张王李赵",

        "EconKind": "有限责任公司(外国法人独资)",

        "Address": "北京市某区某路某大厦666号",

        "Name": "赵县安林小卖部。",

        "TermStart": 948124800000,

        "StartDate": 948124800000,

        "TeamEnd": 1610812800000,

        "Scope": "开发、生产计算机软件；提供相关技术咨询、技术服务、技术培训；承接计算机网络系统工程；销售自产产品、医疗器械II类；货物进出口、技术进出口、代理进出口；设计、制作、代理、发布广告；软件开发；销售第三类医疗器械。（销售第三类医疗器械以及依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动。）",

        "CheckDate": 1549814400000

    },

"orderNo":"idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message":"提交参数信息不完整或参数格式不正确",

}

5.2.1.2 法定代表人身份证简项

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 企业实名认证综合接口——法定代表人身份证简项认证方式

    public static void legalPersonAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = null;

        String legalName = "张三";

        String legalId = "2******";

        String legalUrl = null;

        String legalImg = null;

        String agentName = null;

        String agentId = null;

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        params.put("legalName", legalName);

        params.put("legalId", legalId);

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

}            

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"法人校验成功",

    "orderNumber":"idc2020011317505097877**"

}

错误返回示例：

xxxxxxxxxx

{

    "status": 100002,

    "message": "提交的参数不完整或格式不正确"

}

5.2.1.3 代理人身份证简项

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

{

    "enterpriseInfo": {

        "OperName": "张勇",

        "TeamEnd": 2230646400000,

        "No": "330100400015575",

        "Name": "北京网联信通科技有限公司",

        "Status": "存续",

        "EndDate": null,

        "CreditCode": "91330100716105852F",

        "StartDate": 936806400000,

        "Address": "杭州市滨江区网商路699号",

        "RegistCapi": "59690万美元",

        "BelongOrg": "杭州市高新区（滨江）市场监督管理局",

        "EconKind": "有限责任公司(台港澳法人独资)",

        "CheckDate": 1497542400000,

        "TermStart": 936806400000,

        "Scope": "开发、销售计算机网络应用软件；设计、制作、加工计算机网络产品并提供相关技术服务和咨询服务；服务：自有物业租赁，翻译，成年人的非证书劳动职业技能培训，成年人的非文化教育培训（涉及许可证的除外）。"

    },

    "message": "企业验证成功，二要素比对成功",

    "status": "1",

    "orderNumber": "YYCSidb201810291516419468349"

}            

正确返回示例：

xxxxxxxxxx

{

    "status":1,

    "message":"代理人校验成功",

    "orderNumber":"idc2020011317505097877**"

}

错误返回示例：

xxxxxxxxxx

{

    "status":100002,

    "message":"提交的参数不完整或格式不正确"

}

5.2.1.4 企业三要素核验

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 企业实名认证综合接口——营业执照认证方式

    public static void licenseAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = null;

        String legalName = null;

        String legalId = null;

        String legalUrl = null;

        String legalImg = null;

        String agentName = null;

        String agentId = null;

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        Map<String, String> headers = new HashMap<>();

        //注意：以下计算签名Content-Signature时，请按签名字段顺序，并且每个字段不可缺少，本认证方式不要求的字段，请定义为null

        //注意："HMAC-SHA1 "字符串中最后一位是一个空格

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

    // 企业实名认证综合接口——营业执照+组织机构代码认证方式

    public static void organizationAuth() throws Exception {

        String SECRET_KEY = "158e******";

        String appId = "4c17******";

        String serviceCode = "idc****";

        String type = "ET_PE";

        String name = "******有限公司";

        String idCode = "9133******";

        String orgCode = "******";

        String legalName = null;

        String legalId = null;

        String legalUrl = null;

        String legalImg = null;

        String agentName = null;

        String agentId = null;

        String agentUrl = null;

        String agentImg = null;

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("name", name);

        params.put("type", type);

        params.put("idCode", idCode);

        params.put("orgCode", orgCode);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + Base64.getEncoder().encodeToString(HMACSHA1.getHmacSHA1(appId + serviceCode + type + name + idCode + orgCode + legalName + legalId + legalUrl + legalImg + agentName + agentId + agentUrl + agentImg, SECRET_KEY)));

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/authIden", params, headers);

        System.out.println(response);

    }

}        

正确返回示例：

xxxxxxxxxx

{

    "status": 1,

    "message": "企业基本信息比对成功。",

    "enterpriseInfo": {

        "Status": "在营（开业）",

        "RegistCapi": "(万美元)4520.000000",

        "No": "110000410144104",

        "BelongOrg": "北京市工商行政管理局海淀分局",

        "OperName": "张王李赵",

        "EconKind": "有限责任公司(外国法人独资)",

        "Address": "北京市某区某路某大厦666号",

        "Name": "赵县安林小卖部。",

        "TermStart": 948124800000,

        "StartDate": 948124800000,

        "TeamEnd": 1610812800000,

        "Scope": "开发、生产计算机软件；提供相关技术咨询、技术服务、技术培训；承接计算机网络系统工程；销售自产产品、医疗器械II类；货物进出口、技术进出口、代理进出口；设计、制作、代理、发布广告；软件开发；销售第三类医疗器械。（销售第三类医疗器械以及依法须经批准的项目，经相关部门批准后依批准的内容开展经营活动。）",

        "CheckDate": 1549814400000

    },

    "orderNo": "idc2020011414265759110**"

}

错误返回示例：

xxxxxxxxxx

{

    "status": 100002,

    "message": "企业类型为ET_OU时，idCode和orgCode二选一，不能同时输入"

}

##

5.2.2营业执照OCR-API

请求参数：

返回值：

info具体返回信息格式

xxxxxxxxxx

{

    "regi": "资金",

    "date": "成立日期",

    "comp": "颁发机关",

    "pers": "负责人/法定代表人",

    "funding": "经费来源",

    "code": "统一社会信用代码",

    "num": "登记号",

    "type": "类型",

    "form": "组成形式",

    "organizer": "主管单位",

    "scope": "业务范围",

    "name": "名称",

    "time": "有效期",

    "addr": "住所",

    "date_issue": "发证日期"

}    

正常调用示例：

xxxxxxxxxx

public class OcrTest {

    private static final String URL = "http://open.itruscloud.com/apigate";

    private static final String APP_ID = "488**********41";

    private static final String SECRET_KEY = "e1fa6e*******************20214f9";

    //企业营业执照ocr验证

    public static void BusinessLicense() throws Exception {

        String appId = APP_ID;

        String serviceCode = "idb1001";

        String base64File = Img2Base64Util.getImgStr("D:\\img\\yyzz.png");

        Map<String, Object> params = new HashMap<String, Object>(4);

        params.put("appId", appId);

        params.put("serviceCode", serviceCode);

        params.put("base64File", base64File);

        Map<String, String> headers = new HashMap<>();

        headers.put("Content-Signature", "HMAC-SHA1 " + new Base64().encodeToString(HMACSHA1.getHmacSHA1(getEnterpriseSign(params), SECRET_KEY)));

        System.out.println(headers.get("Content-Signature"));

        String response = HttpUtil.doPost(URL + "/authapi/image/businessLicense", params, headers);

        System.out.println(response);

    }

}                

正常返回示例：

xxxxxxxxxx

{

    "orderNo": "idc201907171024346088878",

    "message": "营业执照OCR验证成功",

    "status": 1,

    "info": "{"regi":"6580万元","date":"2000年09月26日","comp":"","pers":"陈韶光","funding":"","code":"911101088020176135","num":"","type":"有限责任公司(自然人投资或控股)","form":"","organizer":"","scope":"因特网信息服务业务:销售商用密码产品:货物进出口、技术进住经营活动:不得从事本市产业政策禁止和限制类项日的经营活动.)","name":"北京天威诚信电子商务服务有限公司","time":"2000年09月26日至2020年09月25日","addr":"北京市海淀区上地八街7号院4号楼401A室","date_issue":""}"

}        

5.2.3 企业对公银行账户打款(银联)

5.2.3.1打款申请接口

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

{

    "status": 300002,

    "message": "打款申请中",

    "orderNumber": "idb2020011317505097877**"

}

错误调用示例：

xxxxxxxxxx

{

    "orderNumber": "idb202006231708004987341",

    "message": "失败,原因:银行编码为空且根据银行名称查询银行编码未查询到",

    "status": 2

}

5.2.3.2打款查询接口

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

import java.util.Base64;

import java.util.HashMap;

import java.util.Map;

public class Test {

    // 企业对公银行账户打款查询

    public static void queryIden() throws Exception {

        String orderNumber = "CXQYidb******";

        Map<String, Object> params = new HashMap<String, Object>();

        params.put("orderNumber", orderNumber);

        String response = HttpUtil.doPost("http://******:**/apigate/authapi" + "/enterprise/payment/queryIdenNewPay", params);

        System.out.println(response);

    }

}      

正常返回示例：

xxxxxxxxxx

{

   "message":"打款金额验证成功",

   "status":1

}

错误返回示例：

xxxxxxxxxx

{

   "status":300003,

   "message":"无对应有效打款信息，请重新打款"

}

5.2.3.3打款验证接口

请求参数：

返回值：

正常调用示例：

xxxxxxxxxx

{

    "message":"打款金额验证成功",

    "status":1

}

错误返回示例：

xxxxxxxxxx

{

  "status": 300003,

  "message": "无对应有效打款信息，请重新打款"

}

5.2.3.4打款回调接口

回调请求参数：