电子合同统一接口文档

版本维护说明

接口安全认证

Header说明

签名规则

Header说明

• Content-Type 表示请求内容的类型，”application/json”,必填项，不能为空；
• DJ-Date 表示此次操作的时间格式"yyyyMMddHHmmss"；
• DJ-Content-MD5 表示请求内容数据的MD5值，对消息内容（不包括头部）计算MD5值获得128比特位数字，对该数字进行16进制编码而得到，如”1a897bc62d798e”，也可以为空；
• DJ-Authorization 签名，值 = "DianJu:" + appKey + “:” + Signature。

Signature计算方法

Signature = getHmacSignSha1( DJ-Content-MD5 + “” + Content-Type + “” + DJ-Date，appSecret )

• AppKey签名所需，由电子合同平台分配；
• 表示换行符；
• 签名的字符串必须为 UTF-8 格式。含有中文字符的签名字符串必须先进行 UTF-8 编码，再与 AccessKeySecret计算最终签名；
• Content-Type 和 DJ-Content-MD5 在请求中不是必须的，但是如果请求需要签名验证，空值的话以空字符串 ""代替,之后的换行符仍不可去掉。

getHmacSignSha1 Java实现

    private final static String CHAR_SET = "UTF-8";
    private final static String HAMC_SHA1 = "HmacSHA1";   


    /**
     * hmac_sha1 加密
     * @param content  内容
     * @param key 加密秘钥
     * @return 经过base64编码后的hmac
     */
    public static String getHmacSignSha1(String content,String appKey){
        return getHmacSign(content, key, HAMC_SHA1);
    }

    /**
     * hmac+签名算法 加密
     * @param content  内容
     * @param key 加密秘钥
     * @param hamaAlgorithm hamc签名算法名称:例如HmacMD5,HmacSHA1,HmacSHA256
     * @return 经过base64编码后的hmac
     */
    public static String getHmacSign(String content,String key,String hamaAlgorithm){
        byte[] result = null;
        try {
            //根据给定的字节数组构造一个密钥,第二参数指定一个密钥算法的名称
            SecretKeySpec signinKey = new SecretKeySpec(key.getBytes(), hamaAlgorithm);
            //生成一个指定 Mac 算法 的 Mac 对象
            Mac mac = Mac.getInstance(hamaAlgorithm);
            //用给定密钥初始化 Mac 对象
            mac.init(signinKey);
            //完成 Mac 操作
            byte[] rawHmac;
            rawHmac = mac.doFinal(content.getBytes(CHAR_SET));
            //byte字节数组转换16进制，需系统自己实现。
            result = DJHex.byteArrayToHexString(rawHmac);
        } catch (NoSuchAlgorithmException e) {
            System.err.println(e.getMessage());
        } catch (InvalidKeyException e) {
            System.err.println(e.getMessage());
        }  catch (IllegalStateException | UnsupportedEncodingException e) {
            System.err.println(e.getMessage());
        }
        if (null != result) {
            return new String(result);
        } else {
            return null;
        }
    }

接口对接流程

可信签接口调用

企业管理

创建企业

接口描述：

    用于创建企业信息及企业下面的组织机构信息

1. 一个统一社会信信用代码只能创建一个企业
2. 企业下部门信息，按照部门名称+统一信用代码进行检查，如果存在直接返回以前的部门ID

服务名称：

    /v1/company/common/create

请求方式：

    POST

请求参数

adminUserObj

organizeArray

响应参数

createCompanyExtendResult

createCompanyofOrginzeList

adminUserResult | 参数 | 类型 | 描述 | | ----------- | ------ | ------------------- | | accountId | string | 管理员用户ID | | uniqueId | string | 业务系统用户唯一标识，如果创建的时候有值侧返回 | | userName | string | 管理员用户姓名 |

请求json

{
    "name":"企业名称",
    "registerNo":"统一社会信用代码",
    "legalPerson":"企业法人姓名",
    "address":"企业地址",
    "adminUser": {
      /*查询已有用户：accountId 或 uniqueId  | 新创建用户：userName、mobile、licenseType、licenseNumber */
      "accountId":"企业管理员ID",
      "uniqueId":"操作者业务系统唯一用户ID",      
      "userName":"管理员姓名",
      "mobile":"管理员手机号",
      "licenseType":1,  //证件类型: 1. 身份证 2. 中国护照 3. 港澳居民来往内地通行证 4. 台胞证
      "licenseNumber": "1101121991050XXXXX",
    },
    "adminResult":{
        "accountId":"企业管理员ID",
        "uniqueId":"操作者业务系统唯一用户ID",      
        "userName":"管理员姓名"
    },
    "organizeList":[{
        "name":"部门名称1",
        "uniqueId":"业务系统中唯一机构ID",
        "organizeType":1,
        "parentId":"父机构ID",
        "registerNo":"机构的统一信用代码",
        "legalPerson":"机构法人姓名",
        "address":"机构的注册地址"
      },
      {
          "name":"部门名称1",
          "uniqueId":"业务系统中唯一机构ID",
          "organizeType":2,
          "parentId":"父机构ID"
         
      }
    ],
    "uniqueId":"业务系统关联唯一标识",
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"
  }

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "companyId":"",
        "status":"新增/修改",
        "organizeList":[
            {
                "organizeId":"组织机构ID",
                "uniqueId":"业务系统中唯一机构ID",
                "status":"新增/修改",
            },
            {
                "organizeId":"组织机构ID2",
                "uniqueId":"业务系统中唯一机构ID",
                "status":"新增/修改",
            }
        ]
    }
}

删除企业信息

接口描述：

    用于删除企业信息

1. 删除机构将同时吊销此机构下的证书，注销此机构下的印章

2. 含有未签署的任务，不能删除

服务名称：

    /v1/company/common/delete

请求方式：

    POST

请求参数

响应参数

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的企业唯一标识"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{}
}

修改企业信息

接口描述：

    用于修改企业信息及企业下机构信息 > 1. 如果企业已经做实名认证，如果对企业名称、统一信用代码或企业法人进行修改，企业需要重新做实名认证，企业所属的印章会改成停用 > 2. 企业下属的法人机构，如果已做实名认证机构，修改机构名称、机构统一信用代码或机构的法人进行修改，机构需要重新做实名认证，机构所属的印章会改成停用

服务名称：

    /v1/company/common/update

请求方式：

    POST

请求参数

adminUserObj

updateCompanyExtendResult

响应参数

updateCompanyExtendResult

updateCompanyofOrginzeList

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的企业ID",    
    "name":"企业名称",
    "registerNo":"统一社会信用代码",
    "legalPerson":"企业法人姓名",
    "address":"企业地址",
    "adminUser": {
      /*查询已有用户：accountId 或 uniqueId  | 新创建用户：userName、mobile、licenseType、licenseNumber */
      "accountId":"企业管理员ID",
      "uniqueId":"操作者业务系统唯一用户ID",      
      "userName":"管理员姓名",
      "mobile":"管理员手机号",
      "licenseType":1,  //证件类型: 1. 身份证 2. 中国护照 3. 港澳居民来往内地通行证 4. 台胞证
      "licenseNumber": "1101121991050XXXXX",
    },
    "organizeList":[{
        "organizeId":"组织机构ID",
        "name":"部门名称1",
        "uniqueId":"业务系统中唯一机构ID",
        "organizeType":1,
        "parentId":"父机构ID",
        "registerNo":"机构的统一信用代码",
        "legalPerson":"机构法人姓名",
        "address":"机构的注册地址"
      },
      {
          "organizeId":"组织机构ID",
          "name":"部门名称1",
          "uniqueId":"业务系统中唯一机构ID",
          "organizeType":2,
          "parentId":"父机构ID"
      }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"    
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "companyId":"",
        "status":"新增/修改",
        "organizeList":[
            {
                "organizeId":"组织机构ID",
                "uniqueId":"业务系统中唯一机构ID",
                "status":"新增/修改",
            },
            {
                "organizeId":"组织机构ID2",
                "uniqueId":"业务系统中唯一机构ID",
                "status":"新增/修改",
            }
        ]
    }
}

绑定企业经办人

接口描述：

    用于绑定企业经办人，如果未指定组织机构绑定到企业下的默认部门中 > 1. 待绑定的用户可以通过accountId 或 uniqueId获取已有用户，也可以通过userName、mobile、licenseType、licenseNumber 新创建用户

服务名称：

    /v1/company/common/bindUser

请求方式：

    POST

请求参数

bindUsers

响应参数

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联ID",
    "users":[
        {
            /*查询已有用户：accountId 或 uniqueId  | 新创建用户：userName、mobile、licenseType、licenseNumber */
            "accountId":"账号ID",
            "uniqueId":"业务系统方关联的账号ID",
            "isDefault":"默认用户标识",
            "job":"法务",
            "organizeId":"组织机构ID",
            "organizeUniqueId":"业务系统关联唯一机构ID",

        },
        {
            "userName":"用户姓名",
            "mobile":"用户手机号",
            "licenseType":1,  //证件类型: 1. 身份证 2. 中国护照 3. 港澳居民来往内地通行证 4. 台胞证
            "licenseNumber": "110112199105XXXXX",
            "isDefault":"默认用户标识2",
            "job":"合同管理员",
            "organizeId":"组织机构ID",
            "organizeUniqueId":"业务系统关联唯一机构ID",
        }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{}
}

解绑企业经办人

接口描述：

    用于接触绑定企业经办人

服务名称：

    /v1/company/common/unBindUser

请求方式：

    POST

请求参数

unBindUsers

响应参数

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联ID",
    "users":[
        {
            "accountId":"账号ID",
            "uniqueId":"业务系统方关联的账号ID"
        },
        {
            "accountId":"账号ID2",
            "uniqueId":"业务系统方关联的账号ID2"
        }
    ]
}

响应json

{
    "code":200,
    "message":"success",
    "data":{}
}

查询接口管理企业信息

接口描述：

    用于查询接口用户管理企业信息及集团的下属企业

服务名称：

    /v1/company/query

请求方式：

    POST

请求参数

响应参数

companyInfo

请求json

{ 
    "companyName":"机构名称",
    "accountId":"操作者用户ID",
    "accountUniqueId":"业务系统关联的唯一用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
          {
              "companyId":"企业ID",
              "companyName":"企业名称1",
              "uniqueId":"业务系统中唯一企业ID",
              "registerNo":"企业的统一信用代码",
              "legalPerson":"企业法人姓名",
              "address":"企业的注册地址",
              "status":"企业状态"
          },
          {
              "companyId":"企业ID",
              "companyName":"企业名称2",
              "uniqueId":"业务系统中唯一企业ID",
              "registerNo":"企业的统一信用代码",
              "legalPerson":"企业法人姓名",
              "address":"企业的注册地址",
              "status":"企业状态"
          }
      ]     
    
}

查询机构信息

接口描述：

    用于查询企业下机构信息

服务名称：

    /v1/company/organizes

请求方式：

    POST

请求参数

响应参数

organizeInfo

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统唯一单位标识ID",
    "organizeName":"机构名称",
    "accountId":"操作者用户ID",
    "accountUniqueId":"业务系统关联的唯一用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
          {
              "organizeId":"组织机构ID",
              "organizeName":"部门名称1",
              "organizeNo":"部门编号1",
              "uniqueId":"业务系统中唯一机构ID",
              "organizeType":2,
              "parentId":"父机构ID",
              "registerNo":"机构的统一信用代码",
              "legalPerson":"机构法人姓名",
              "address":"机构的注册地址"
          },
          {
              "organizeId":"组织机构ID",
              "organizeName":"部门名称2",
              "organizeNo":"部门编号2",
              "uniqueId":"业务系统中唯一机构ID",
              "organizeType":1,
              "parentId":"父机构ID",
              "registerNo":"机构的统一信用代码",
              "legalPerson":"机构法人姓名",
              "address":"机构的注册地址"
          }
      ]
     
    
}

获取企业用户列表

接口描述：

    获取企业下用户列表

服务名称：

    /v1/company/users

请求方式：

    POST

请求参数

响应参数

users

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联ID",
    "organizeIdList":["组织机构ID1","组织机构ID2"]

}

响应json

{
    "code":200,
    "message":"success",
    "data":[
          {
              "userId":"可信签用户唯一标识",
              "userName":"用户名称",
              "uniqueId":"用户关联的唯一用户标识",
              "accountId":"用户登录账号",
              "organizeId":"组织机构ID",
              "organizeName":"组织机构名称",
              "job":"用户职务"
          },
          {
              "userId":"可信签用户唯一标识",
              "userName":"用户名称",
              "uniqueId":"用户关联的唯一用户标识",
              "accountId":"用户登录账号",
              "organizeId":"组织机构ID",
              "organizeName":"组织机构名称",
              "job":"用户职务"
          }
      ]
    
}

新增组织机构

接口描述：

    用于维护开发者账号所属企业的组织机构

服务名称：

    /v1/company/organize/create

请求方式：

    POST

请求参数

organizeInfo

响应参数

organize

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的企业ID",
    "organizeList":[{       
        "name":"部门名称1",
        "uniqueId":"业务系统方关联部门ID",
        "organizeNo":"部门编号",
        "organizeType":2,
        "parentId":"父机构ID"        
      },
      {
          "name":"部门名称2",
          "uniqueId":"业务系统方关联部门ID",
          "organizeNo":"部门编号2",
          "organizeType":2,
          "parentId":"父机构ID"
      }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"    
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
       "companyId":"企业ID",
       "uniqueId":"业务系统方关联的ID",
       "organizeList":[ {
            "organizeId":"组织机构ID",
            "uniqueId":"业务系统方关联的机构唯一标识1"
        },
        {
            "organizeId":"组织机构ID2",
            "uniqueId":"业务系统方关联的机构唯一标识2"
        }]
    }
}

修改组织机构

接口描述：

    用于修改开发者账号所属企业的组织机构

服务名称：

    /v1/company/organize/update

请求方式：

    POST

请求参数

organizeInfo

响应参数

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的ID",
    "organizeList":[{
        "organizeId":"组织机构ID",  
        "uniqueId":"业务系统方关联部门ID",
        "name":"部门名称1",  
        "organizeNo":"部门编号", 
        "organizeType":1,
        "parentId":"父机构ID",
        "registerNo":"机构的统一信用代码",
        "legalPerson":"机构法人姓名",
        "address":"机构的注册地址"
      },
      {
        "organizeId":"组织机构ID",  
        "uniqueId":"业务系统方关联部门ID",  
        "name":"部门名称1",
        "organizeNo":"部门编号1",
        "organizeType":2,
        "parentId":"父机构ID"
      }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"    
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

删除组织机构

接口描述：

    用于删除企业下的组织机构，如果组织机构下有用户不进行删除。

服务名称：

    /v1/company/organize/delete

请求方式：

    POST

请求参数

响应参数

请求json

{
   "organizeId":"组织机构ID",
   "uniqueId":"业务系统方关联的组织机构ID",
   "companyId":"企业ID",
   "accountId":"操作者ID",
   "accountUniqueId":"业务系统关联的唯一用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

新增下属企业

接口描述：

    用于维护开发者账号所属企业的下属企业信息

服务名称：

    /v1/company/subsidiary/create

请求方式：

    POST

请求参数

subsidiaryInfo

响应参数

subsidiaryResult

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的企业ID",
    "subsidiaryList":[{       
        "companyId":"下属企业ID",
        "uniqueId":"业务系统方关联企业ID",
        "registerNo":"企业统一信用代码",
        "companyName":"下属公司名称",
      },
      {
        "companyId":"下属企业ID",
        "uniqueId":"业务系统方关联企业ID",
        "registerNo":"企业统一信用代码",
        "companyName":"下属公司名称",
      }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"    
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
          "companyId": "公司ID1",
          "message": "添加成功！",
          "status": true
        },
        {
          "companyId": "公司ID2",
          "message": "添加失败！",
          "status": false
        }
    ]
}

删除下属企业

接口描述：

    用于删除开发者账号所属企业的下属企业信息

服务名称：

    /v1/company/subsidiary/delete

请求方式：

    POST

请求参数

subsidiaryInfo

响应参数

subsidiaryResult

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的企业ID",
    "organizeList":[{       
        "companyId":"下属企业ID",
        "uniqueId":"业务系统方关联企业ID",
        "registerNo":"企业统一信用代码"
      },
      {
        "companyId":"下属企业ID",
        "uniqueId":"业务系统方关联企业ID",
        "registerNo":"企业统一信用代码"
      }
    ],
    "accountId":"操作者ID",
    "accountUniqueId":"操作者业务系统唯一用户ID"    
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
          "companyId": "公司ID1",
          "message": "删除成功！",
          "status": true
        },
        {
          "companyId": "公司ID2",
          "message": "删除失败！",
          "status": false
        }
    ]
}

用户管理

创建组织机构用户

接口描述：

    用于创建指定机构下的用户，如果未设置 organizeId 默认绑定在开发者账户所属企业下默认组织机构下面。

1. 一个证件号码，仅允许创建一个用户，如果存证相同证件号的用户，直接返回原证件号的accountId
2. 创建用户后，用户的初始默认密码为证件号后六位；如果用户已存在不更改原账号密码
3. 建立组织机构与用户之间的隶属管理

服务名称：

    /v1/user/company/create

请求方式：

    POST

请求参数

响应参数

retUserInfo

请求json

{
    "companyId":"公司ID",
    "uniqueId":"业务系统公司唯一标识",
    "userName":"张三",
    "licenseType":1,
    "licenseNumber": "11011219910506XXXX",
    "mobile":"18611888888",
    "email":"8988888@qq.com",    
    "uniqueId":"J8H6G8K4E3",
    "organizeId":"组织机构ID1",
    "organizeUniqueId":"业务系统关联唯一机构标识",
    "job":"法务"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
      "accountId":"可信签系统用户ID",
      "uniqueId":"业务系统关联唯一用户ID"
    }
}

机构批量导入用户

接口描述：

    用于创建指定机构下的用户，如果未设置 organizeId 默认绑定在开发者账户所属企业下默认组织机构下面。

1. 一个证件号码，仅允许创建一个用户，如果存证相同证件号的用户，直接返回原证件号的accountId
2. 创建用户后，用户的初始默认密码为证件号后六位；如果用户已存在不更改原账号密码
3. 建立组织机构与用户之间的隶属管理

服务名称：

    /v1/user/company/batch/create

请求方式：

    POST

请求参数

batchUsers

响应参数

retUserInfo

请求json

{
    "companyId":"公司ID",
    "userList":[
      {
        "userName":"张三",
        "licenseType":1,
        "licenseNumber": "11011219910506XXXX",
        "mobile":"18611888888",
        "email":"8988888@qq.com",
        "uniqueId":"J8H6G8K4E3",
        "organizeId":"组织机构ID1",
        "organizeUniqueId":"业务系统关联唯一机构标识",        
        "job":"法务",        
      },
      {
        "userName":"张三",
        "licenseType":1,
        "licenseNumber": "11011219910506XXXX",
        "mobile":"18611888888",
        "email":"8988888@qq.com",
        "uniqueId":"J8H6G8K4E3",
        "organizeId":"组织机构ID1",
        "organizeUniqueId":"业务系统关联唯一机构标识",
        "job":"印章管理员"
      }
    ],
    "operAccountId":"操作用户ID",
    "operAccountUniqueId":"业务系统关联唯一用户标识" 
    
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
          "accountId":"可信签系统用户ID-1",
          "uniqueId":"业务系统关联唯一用户ID"
        },
        {
          "accountId":"可信签系统用户ID-2",
          "uniqueId":"业务系统关联唯一用户ID"
        }
     ]
}

修改组织机构用户

接口描述：

    用于修改企业用户信息（开发者账号绑定的企业） > 1. 用户已做实名认证不允许修改用户姓名、证件号类型、证件号码，其他信息可以进行更新。 > 2. 如果组织机构信息有变化，按照最新的建立机构隶属关系

服务名称：

    /v1/user/company/update

请求方式：

    POST

请求参数

响应参数

请求json

{
    "companyId":"用户所属公司ID",
    "companyUniqueId":"业务系统关联企业唯一标识",
    "accountId":"用户账号ID,创建用户时返回",
    "uniqueId":"业务系统关联的唯一用户ID",
    "userName":"张三",
    "licenseType":1,
    "licenseNumber": "11011219910506XXXX",
    "mobile":"18611888888",
    "email":"8988888@qq.com",
    "organizeId":"组织机构ID1",
    "organizeUniqueId":"业务系统关联唯一机构标识",
    "job":"合同管理员",
    "operAccountId":"操作用户ID",
    "operAccountUniqueId":"业务系统关联唯一用户标识"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{ }
}

删除组织机构用户

接口描述：

    用于删除指定机构下的用户 > 1. 此功能只删除机构和用户隶属关系、单位印章授权、单位模板使用权限及流程使用权限 > 2. 如果有用户的待办事项不允许做删除操作 > 3. 个人账户信息不做删除

服务名称：

    /v1/user/company/delete

请求方式：

    POST

请求参数

响应参数

请求json

{
    "accountId":"用户账号ID,创建用户时返回",
    "uniqueId":"J8H6G8K4E3",
    "companyId":"企业ID",
    "operAccountId":"操作者ID",
    "operAccountUniqueId":"操作者关联用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{}
}

查询用户信息

接口描述：

    通过传入的用户姓名、手机号、身份证号、Email等信息查询满足需求的用户信息，以上4个参数至少1个有值。

服务名称：

    /v1/user/common/query

请求方式：

    POST

请求参数

参数 | 类型 | 必须 | 描述 |
------------------- | ------ | ----- | ---------------------------------------------------------- --------- |
userName | string | false | 用户名称 |
licenseType | int | false | 证件类型: 1. 身份证 2. 中国护照 3. 港澳居民来往内地通行证 4. 台胞证 |
licenseNumber | string | false | 证件号码 |
mobile | string | false | 手机号或者email有一项必填 |
email | string | false | email或者手机号有一项必填 |

响应参数

users

请求json

{
    "userName":"张三",
    "licenseType":1,
    "licenseNumber": "11011219910506XXXX",
    "mobile":"18611888888",
    "email":"8988888@qq.com"
    
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
            "userId":"可信签用户唯一标识",
            "userName":"用户名称",
            "uniqueId":"用户关联的唯一用户标识",
            "accountId":"用户登录账号"
        },
        {
            "userId":"可信签用户唯一标识",
            "userName":"用户名称",
            "uniqueId":"用户关联的唯一用户标识",
            "accountId":"用户登录账号"
        }
    ]
}

增加ukey绑定的后台接口

接口描述：

返回个人中心地址，用于绑定ukey及其他信息

服务名称：

/v1/user/common/personal

请求方式：

POST

请求参数

响应参数

请求json

{
  "accountId": "15699183993",
  "companyId": "ent001"
}

响应json

{
  "code": 200,
  "message": "success",
  "data": {
    "viewUrl": "http://127.0.0.1:8081/#/v1/personal?JZNXJTHPKS"
  }
}

单点登录

接口描述：

返回个人系统主页面

服务名称：

/v1/user/common/login

请求方式：

POST

请求参数

响应参数

请求json

{
  "accountId": "15699183993",
  "companyId": "ent001"
}

响应json

{
  "code": 200,
  "message": "success",
  "data": {
    "viewUrl": "http://127.0.0.1:8081/#/v1/login?JZNXJTHPKS"
  }
}

认证管理

运营商三要素验证

接口描述：

    采用运营商三要素接口，验证个人用户身份

服务名称：

    /v1/identity/verify/mobile3Element

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "accountId":"用户登录ID",
    "uniqueId":"业务系统对接方关联的唯一用户ID",
    "idCard":"身份证号码",
    "userName":"用户姓名",
    "mobile":"手机号",
    "verifyCode":"短信验证码"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "flowId":"验证流水号",
        "provider":"验证服务商"
    }
}

银行卡四要素

接口描述：

   使用个人姓名、身份证号、银行卡号和银行预留手机号做一致性校验

服务名称：

    /v1/identity/verify/bank4Element

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "cardNo":"身份证号",
    "name":"姓名",
    "bankCardNo":"银行卡号",
    "mobile": "手机号",
    "verifyCode":"短信验证码"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "flowId":"验证流水号",
        "provider":"验证服务商"
    }
}

企业四要素验证

接口描述：

    使用企业四要素：企业法人姓名，企业法人身份证号，企业名称，统一社会信用代码做一致性校验。

服务名称：

     /v1/identity/verify/company4Element

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "legalPersonName":"企业法人姓名",
    "legalPersonIdCard":"法人身份证号码",
    "companyName":"企业名称",
    "registerNo": "统一社会信用代码",
    "companyId":"认证企业ID",
    "uniqueId":"业务系统关联的唯一企业ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
       "flowId":"认证流水ID",
       "provider":"验证服务提供商"
    }
}

企业三要素验证

接口描述：

    使用企业三要素：企业法人姓名，企业名称，统一社会信用代码做一致性校验。

服务名称：

     /v1/identity/verify/company3Element

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "legalPersonName":"企业法人姓名",
    "companyName":"企业名称",
    "registerNo": "统一社会信用代码",
    "companyId":"认证企业ID",
    "uniqueId":"业务系统关联的唯一企业ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
       "flowId":"认证流水ID",
       "provider":"验证服务提供商"
    }
}

组织机构四要素验证

接口描述：

    使用组织机构四要素：法人姓名，法人身份证号，组织机构名称，同一社会信用代码做一致性校验。

服务名称：

     /v1/identity/verify/organize4Element

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "legalPersonName":"企业法人姓名",
    "legalPersonIdCard":"法人身份证号码",
    "organizeName":"企业名称",
    "registerNo": "统一社会信用代码",
    "organizeId":"认证组织机构ID",
    "uniqueId":"业务系统关联的唯一组织机构ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
       "flowId":"认证流水ID",
       "provider":"验证服务提供商"
    }
}

发送短信验证码

接口描述：

    短信验证码

服务名称：

    /v1/sms/send/code

请求方式：

    POST

请求参数

响应参数

请求json

{
    "phone":"手机号",
    "templateId":"短信模板ID",
    "codeLength":6
}

响应json

{
    "code":200,
    "message":"success",
    "data":{

    }
}

验证短信验证码

接口描述：

    校验手机短信验证码

服务名称：

    /v1/sms/verifyCode

请求方式：

    POST

请求参数

响应参数

请求json

{
    "phone":"手机号",
    "code":"验证码"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{

    }
}

企业对公打款（独立模式）

接口描述：

    向企业银行账号随机打款，同时核验企业统一社会信用代码，公司名称，法人信息和对公账号

服务名称：

    /v1/identity/company/publicMoney/send

请求方式：

    POST

请求参数

响应参数

verifyInfo

请求json

{
    "companyId":"组织机构ID",
    "uniqueId":"业务系统关联的唯一组织机构ID",
    "legalPersonName":"企业法人姓名",
    "registerNo":"组织机构代码",
    "companyName":"组织机构名称",
    "accountNo":"对公账号",
    "accountBank":"开户行",
    "accountProv":"开户行所在省",
    "accountCity":"开户行所在市"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "verifyId":"验证流水号",
        "orderId":"验证订单号",
        "orderDate":"验证订单日期"
    }
}

组织机构对公打款（独立模式）

接口描述：

    向企业内组织机构银行账号随机打款，同时核验企业统一社会信用代码，公司名称，法人信息和对公账号

服务名称：

    /v1/identity/organize/publicMoney/send

请求方式：

    POST

请求参数

响应参数

vefifyInfo

请求json

{
    "organizeId":"组织机构ID",
    "uniqueId":"业务系统关联的唯一组织机构ID",
    "legalPersonName":"企业法人姓名",
    "registerNo":"组织机构代码",
    "organizeName":"组织机构名称",
    "accountNo":"对公账号",
    "accountBank":"开户行",
    "accountProv":"开户行所在省",
    "accountCity":"开户行所在市"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "verifyId":"验证流水号",
        "orderId":"验证订单号",
        "orderDate":"验证订单日期"
    }
}

随机金额校验（独立模式）

接口描述：

    对公随机打款金额认证, 独立模式需要使用此接口验证金额

服务名称：

    /v1/identity/alone/publicMoney/verify

请求方式：

    POST

请求参数

响应参数

publicMoneyInfo

请求json

{
    "flowId":"实名认证流程ID",
    "amount":"金额"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{

    }
}

人脸验证

接口描述：

    个人用户，通过人脸进行认证。

服务名称：

    /v1/identity/face/verify

请求方式：

    POST

请求参数

响应参数

faceVerifyResult

请求json

{
    "idCard":"身份证号",
    "userName":"待认证用户名称",
    "returnUrl":"认证成功后跳转地址",
    "accountId":"登录账号ID",
    "uniqueId":"业务系统关联的唯一用户ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "verifyId":"认证ID,可用于查询",
        "verifyUrl":"认证地址",
        "provider":"人脸识别工具"
    }
}

人脸验证查询

接口描述：

    查询人脸验证结果

服务名称：

    /v1/identity/face/queryResult

请求方式：

    POST

请求参数

响应参数

verifyResult

请求json

{
    "verifyId":"验证流水号"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "verifyResult":"成功: 认证通过 失败：认证失败 认证中：未认证"
    }
}

证书管理

通用个人签名证书申请

接口描述：

    用于申请个人或企业证书

1. 普通个人，同时仅允许一张同一算法的生效证书。

2. 只有实名认证通过的用户才能申请证书。

服务名称：

    /v1/cert/user/apply

请求方式：

    POST

请求参数

响应参数

userCertInfo

请求json

{
    "accountId":"用户ID",
    "uniqueId":"业务系统方关联的唯一用户标识",
    "algorithm":0,
    "valid": 12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

通用个人签名证书续期

接口描述：

    用于个人签名证书的续期

1. 续期仅能变更证书的有效期，如需变更证书算法，需重新申请一张新证书。

服务名称：

    /v1/cert/user/renewal

请求方式：

    POST

请求参数

响应参数

userCertInfo

请求json

{
    "accountId":"账号ID",
    "uniqueId":"业务系统方关联的唯一用户标识",
    "certNo":"证书序列号",
    "valid":12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

通用个人签名证书吊销

接口描述：

    用于吊销个人证书。

1. 个人证书吊销后，如果此用户下无可用证书，将不能进行任何合同的签署。

服务名称：

    /v1/cert/user/revoke

请求方式：

    POST

请求参数

响应参数

请求json

{
    "accountId":"账号ID",
    "uniqueId":"业务系统方关联的唯一用户标识",
    "certNo":"证书序列号"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

通用企业签名证书申请

接口描述：

    用于申请企业证书

1. 企业或组织机构下同时仅允许一张同一算法的生效证书。

2. 只有实名认证通过的企业才能申请证书。

服务名称：

    /v1/cert/company/apply

请求方式：

    POST

请求参数

响应参数

certInfo

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的唯一用户标识",
    "organizeId":"",
    "organizeUniqueId":"",
    "algorithm":0,
    "valid": 12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certId":"证书ID",
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

通用企业签名证书续期

接口描述：

    用于企业签名证书的续期

1. 续期仅能变更证书的有效期，如需变更证书算法，需重新申请一张新证书。

服务名称：

    /v1/cert/company/renewal

请求方式：

    POST

请求参数

响应参数

certInfo

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的唯一企业标识",
    "organizeId":"",
    "organizeUniqueId":"",
    "certNo":"证书序列号",
    "valid":12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certId":"证书ID",
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

通用企业签名证书吊销

接口描述：

    用于吊销企业证书。

1. 企业证书吊销后，如果此企业下无可用证书，将不能进行任何合同的签署。

服务名称：

    /v1/cert/company/revoke

请求方式：

    POST

请求参数

响应参数

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的唯一企业标识",
    "organizeId":"",
    "organizeUniqueId":"",
    "certNo":"证书序列号"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

企业组织机构签名证书申请

接口描述：

    用于申请企业证书，默认关联在开发者账户下

1. 企业或组织机构下同时仅允许一张同一算法的生效证书。

2. 只有实名认证通过的企业才能申请证书。

服务名称：

    /v1/cert/apply

请求方式：

    POST

请求参数

响应参数

userCertInfo

请求json

{
    "organizeId":"组织机构ID",
    "uniqueId":"业务系统方关联的唯一用户标识",
    "accountId":"操作者账号",
    "accountUniqueId":"业务系统关联的唯一用户ID",
    "algorithm":0,
    "valid": 12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certId":"证书ID",
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

企业组织机构签名证书续期

接口描述：

    用于企业或者组织机构内签名证书的续期，默认操作绑定开发者账号下证书。

1. 续期仅能变更证书的有效期，如需变更证书算法，需重新申请一张新证书。

服务名称：

    /v1/cert/renewal

请求方式：

    POST

请求参数

响应参数

userCertInfo

请求json

{
    "organizeId":"企业组织机构ID",
    "uniqueId":"业务系统方关联的唯一企业标识",
    "accountId":"操作者账号",
    "accountUniqueId":"业务系统关联的唯一用户ID",
    "certNo":"证书序列号",
    "valid":12
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
        "certId":"证书ID",
        "certNo":"证书序列号",
        "dn":"证书dn项",
        "beginTime":"证书生效时间",
        "afterTime":"证书失效时间"
    }
}

企业组织机构签名证书吊销

接口描述：

    用于吊销企业证书，默认操作绑定开发者账号下证书。

1. 企业证书吊销后，如果此企业下无可用证书，将不能进行任何合同的签署。

服务名称：

    /v1/cert/revoke

请求方式：

    POST

请求参数

响应参数

请求json

{
    "organizeId":"组织机构ID",
    "uniqueId":"业务系统关联的唯一组织机构标识",
    "accountId":"操作者账号",
    "accountUniqueId":"业务系统关联的唯一用户ID",
    "certNo":"证书序列号"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

印章管理

企业印章制作-模板模式

接口描述：

   用于申请企业或企业下机构下印章 > 1. 如果设置organizeId 或 organizeUniqueId 制作对应机构下的电子印章，为空制作企业电子印章

服务名称：

    /v1/seal/template/company/create

请求方式：

    POST

请求参数

sealInfo

mainFontInfo

viceFontInfo

bandRingInfo

sealHandleInfo

响应参数

sealResult

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID",    
    "sealInfoList": [{
            "sealName": "num0001",
            "sealNo":"业务系统方绑定的唯一印章编号",
            "sealStruct": "sel",
            "sealTemp": 3,
            "sealWidth": 4200,
            "sealHeight": 4200,
            "frontColor":0,
            "outlineBorder":0,
            "imageType": "gif",
            "mainFont": {
                "fontText": "张三",
                "fontSize": 700,
                "fontFlag": 0,
                "fontFamily": "宋体",
                "fontWidthzoom": 30,
                "marginSize": 10
            },
            "viceFont": {
                "fontText": "合同专用章",
                "fontSize": 700,
                "fontFlag": 0,
                "fontWidthzoom": 30,
                "marginSize": 500
            },
            "sealHandle": {
                "accountId":"账号ID",
                "uniqueId":"业务系统方关联的用户唯一标识",
                "isDefault":false
            }
        }
    ],
    "accountId": "操作账号ID",
    "accountUniqueId": "业务对接方关联的唯一用户标识"
}

响应json

{
    "code":200,
    "message":"success",
    "data":[{
        "sealId":"印章ID",
        "sealName":"印章名称",
        "sealNo":"业务系统绑定的唯一印章编号",
        "sealImageBase64":"印章预览图片"
    }]
}

企业印章修改-模板模式

接口描述：

    用于修改企业或企业下属机构的印章

服务名称：

    /v1/seal/template/company/update

请求方式：

    POST

请求参数

sealInfo

mainFontInfo

viceFontInfo

bandFontInfo

sealHandleInfo

响应参数

sealResult

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID",    
    "sealInfoList": [{
            "sealId":"印章ID",
            "sealName": "num0001",
            "sealNo":"业务系统方绑定的唯一印章编号",
            "sealStruct": "sel",
            "sealTemp": 3,
            "sealWidth": 4200,
            "sealHeight": 4200,
            "frontColor":0,
            "outlineBorder":0,
            "imageType": "gif",
            "mainFont": {
                "fontText": "张三",
                "fontSize": 700,
                "fontFlag": 0,
                "fontFamily": "宋体",
                "fontWidthzoom": 30,
                "marginSize": 10
            },
            "viceFont": {
                "fontText": "合同专用章",
                "fontSize": 700,
                "fontFlag": 0,
                "fontWidthzoom": 30,
                "marginSize": 500
            },
            "sealHandle": {
                "accountId":"账号ID",
                "uniqueId":"业务系统方关联的用户唯一标识",
                "isDefault":false
            }
        }
    ],
    "accountId": "操作账号ID",
    "accountUniqueId": "业务对接方关联的唯一用户标识"
}

响应json

{
    "code":200,
    "message":"success",
    "data":[{
        "sealId":"印章ID",
        "sealName":"印章名称",
        "sealNo":"业务系统绑定的唯一印章编号",
        "sealImageBase64":"印章预览图片"
    }]
}

企业印章删除

接口描述：

    用于删除企业印章

服务名称：

    /v1/seal/company/delete

请求方式：

    POST

请求参数

响应参数

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "accountId": "操作账号ID",
    "accountUniqueId": "业务对接方关联的唯一用户标识",
    "sealId":"印章id",
    "sealNo":"印章编号"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

企业印章制作-图片模式

接口描述：

    通过印章图片，制作企业印章

服务名称：

    /v1/seal/image/company/create

请求方式：

    POST

请求参数

sealHandleInfo

响应参数

imageSealResult

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID", 
    "accountId": "操作账号ID",
    "accountUniqueId": "业务对接方关联的唯一用户标识",
    "width":2100,
    "height":2100,
    "imageData":"印章图片base64数据",
    "sealName":"印章名称",
    "sealNo":"印章编号",
    "sealType":1,
    "sealStruct":"印章结构类型,默认sel",
    "sealHandle":{
        "accountId":"账号ID",
        "uniqueId":"业务对接方关联的唯一用户标识",
        "isDefault":false
    }
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

企业印章修改-图片模式

接口描述：

    用于修改通过图片制作的企业印章

服务名称：

    /v1/seal/image/company/update

请求方式：

    POST

请求参数

sealHandleInfo

响应参数

imageSealResult

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID", 
    "accountId": "操作账号ID",
    "accountUniqueId": "业务对接方关联的唯一用户标识",
    "width":2100,
    "height":2100,
    "imageData":"印章图片base64数据",
    "sealName":"印章名称",
    "sealNo":"印章编号",
    "sealStruct":"印章结构类型,默认sel",
    "sealHandle":{
        "accountId":"账号ID",
        "uniqueId":"业务对接方关联的唯一用户标识",
        "isDefault":false
    }
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

企业印章授权

接口描述：

    授权操作人使用印章 > 1. 印章授权时需验证印章 和 授权用户是否在对应的企业和机构下面

服务名称：

    /v1/seal/company/auth

请求方式：

    POST

请求参数

sealHandleInfo

响应参数

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID", 
    "sealId":"印章ID",
    "sealNo": "印章编号",
    "sealHandle":[
      {
        "accountId":"账号ID",
        "uniqueId":"业务系统方关联的唯一用户标识",
        "isDefault": false
      } 
    ] 
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

企业印章取消授权

接口描述：

    取消授权操作人使用印章

服务名称：

    /v1/seal/company/offAuth

请求方式：

    POST

请求参数

sealHandleInfo

响应参数

请求json

{
    "companyId": "企业用户账号ID",
    "uniqueId": "业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID",
    "sealId":"印章ID",
    "sealNo": "印章编号",
    "sealHandle":[
      {
        "accountId":"账号ID",
        "uniqueId":"业务系统方关联的唯一用户标识"
      } 
    ] 
}

响应json

{
    "code":200,
    "message":"success",
    "data":{
    }
}

获取用户授权印章列表

接口描述：

    用于查询账号下可使用的印章列表

服务名称：

    /v1/seal/company/queryAuthSeals

请求方式：

    POST

请求参数

响应参数

sealInfo

请求json

{
    "companyId":"企业ID",
    "companyUniqueId":"业务系统方关联的唯一企业标识",    
    "accountId":"账号ID",
    "accountUniqueId":"业务系统方关联的唯一用户标识"
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
            "sealId":"印章ID",
            "seaName":"印章名称",
            "sealNo":"印章编号",
            "createTime":"印章生成时间",
            "isDefault":false,
            "sealType":1,
            "sealWay":1,
            "sealData":"印章图片base64"
        }
    ]
}

获取企业印章列表

接口描述：

    用于查询该企业下可使用的印章列表

服务名称：

    /v1/seal/queryCompanySeals

请求方式：

    POST

请求参数

响应参数

sealInfo

请求json

{
    "companyId":"企业ID",
    "uniqueId":"业务系统方关联的唯一企业标识",
    "organizeId":"企业下属组织机构ID",
    "organizeUniqueId":"业务系统关联唯一组织机构ID",
}

响应json

{
    "code":200,
    "message":"success",
    "data":[
        {
            "sealId":"印章ID",
            "seaName":"印章名称",
            "sealNo":"印章编号",
            "createTime":"印章生成时间",
            "isDefault":false,
            "sealType":1,
            "sealWay":1,
            "sealData":"印章图片base64"
        }
    ]
}

修改个人默认印章

接口描述：

    修改人员的默认印章

服务名称：

    /v1/user/seal/default

请求方式：

    POST

请求参数

响应参数

请求json

{
    "accountId":"账号ID",
    "uniqueId":"业务系统关联的唯一用户ID",
    "sealId":"印章ID",
    "sealNo":"业务系统关联的唯一印章ID"
}

响应json

{
    "code":200,
    "message":"success",
    "data":{

    }
}

修改企业默认印章

接口描述：

    修改企业的默认印章

服务名称：

    /v1/company/seal/default

请求方式：

    POST

请求参数