开放平台

版本：v1.0.0

用于接口数据上传及员工合同信息获取

开放平台使用说明

开放平台接口为https://ectcs.hrsecn.com/openAPI

1. 在接入开放平台前，请联系平台管理员获取企业公钥

2. 接口说明

返回数据中如果数据为空，则返回null

所有参数请放作为一个JSONObject中作为Request Body请求

数据data需要以utf-8格式编码为base64字符串，再使用public key进行分段加密

加密数据java示例：

    /**
     * RSA最大加密明文大小
     */
  private static final int MAX_ENCRYPT_BLOCK = 117;

    /**
     * 使用公钥加密
     *
     * @param str 数据
     * @param publicKey 公钥字符串
     * @return
     * @throws Exception
     */
  public static String encrypt(String str, String publicKey) throws Exception {
         // base64编码的公钥
         byte[] decoded =  (new BASE64Decoder()).decodeBuffer(publicKey);
         RSAPublicKey pubKey = (RSAPublicKey) KeyFactory.getInstance("RSA").generatePublic(new X509EncodedKeySpec(decoded));
         // RSA加密
         Cipher cipher = Cipher.getInstance("RSA");
         cipher.init(Cipher.ENCRYPT_MODE, pubKey);
         byte []sourceCode=str.getBytes("UTF-8");
         int inputLen = sourceCode.length;
         ByteArrayOutputStream out = new ByteArrayOutputStream();
         int offSet = 0;
         byte[] cache;
         int i = 0;
         // 对数据分段加密
         while (inputLen - offSet > 0) {
             if (inputLen - offSet > MAX_ENCRYPT_BLOCK) {
                 cache = cipher.doFinal(sourceCode, offSet, MAX_ENCRYPT_BLOCK);
             } else {
                 cache = cipher.doFinal(sourceCode, offSet, inputLen - offSet);
             }
             out.write(cache, 0, cache.length);
             i++;
             offSet = i * MAX_ENCRYPT_BLOCK;
         }
         byte[] encryptedData = out.toByteArray();
         out.close();
         String outStr = Base64.encode(encryptedData);
         return outStr;
     }

导入部门 action=importDepart

在企业新建时会产生pid为-1，名称为企业名称的部门，导入人员时若不指定部门，则默认导入该部门

删除部门时该部门下所有员工默认归属到企业默认部门下

• 入参

其中data为JSONArray结构

• 返回值

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "importDepart",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data": "e3HHTeJH1OiOv+************x3fvv/uYPxvO9z4eXEXGKr***********PIIvoCrefwF2LXoZyQRLlB/ONOsrkTV********1XCBTpk8B0LejgBO7R6dPZUglcgRNRAs6FueNq*********OVFcz4qfCkMehgxh79U3BwM1dIXUpyQKQkWc+uGkFeFabLeXMa878OgplwvQnALfLgrfkyVXdbXKSXh******8cwpXQG0pRkEVcXzCHcPTG86jIVCzY18Rky8Pjw=="
}

其中 data 原始数据为
data:[{
    depart_name: "测试部门1",
    depart_address: "**楼",
    comments: "**楼",
    contact_information: "101",
    children: [{
        depart_name: "测试部门1_1",
        depart_address: "**楼",
        comments: "**楼",
        contact_information: "1011"
    }]
}]

正常返回值为

{
    "code": null,
    "data": "成功2条,插入1条,更新1条,失败0条",//失败1条（原因为：）
    "success": true,
    "message": "successful！",
    "status": "default"
}

删除部门 action=removeDepart

删除部门时该部门下所有员工默认归属到企业默认部门下

• 入参

其中 data为JSONArray结构

• 返回值

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "removeDepart",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data": "a8LluZaiagwlgbIDRH+************x3fvv/uYPxvO9z4eXEXGKr***********PIIvoCrefwF2LXoZyQRLlB/ONOsrkTV********1XCBTpk8B0LejgBO7R6dPZUglcgRNRAs6FueNq*********OVFcz4qfCkMehgxh79U3BwM1dIXUpyQKQkWc+uGkFeFabLeXMa878OgplwvQnALfLgrfkyVXdbXKSXh******8cwpXQG0pRkEVcXzCHcPTG86jIVCzY18Rky8Pjw=="
}

其中 data 原始数据为

data:[{depart_name: "测试部门1"}]

正常返回值为

{
    "code": null,
    "data": "成功1条，失败0条",
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取部门列表 action=listDepart

• 入参

• 返回值

data为JSONArray结构

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "listDepart",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
}

正常返回值为

{
    "code": null,
    "data": [
        {
            "comments": null,
            "contact_information": null,
            "depart_address": null,
            "depart_id": "00afe***e-***88b2fc",
            "depart_name": "研发组二",
            "pid": "ef6****fc-*****00afe088",
        }.....
    ],
    "success": true,
    "message": "successful！",
    "status": "default"
}

导入人员 action=importUser

• 入参

data为JSONArray结构

• 返回值

• 请求示例

HTTP请求示例

GET /openAPI HTTP/1.1
Host: https://ectcs.hrsecn.com
Content-Type: application/json
{
    "action": "importUser",
    "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
    "data": "Pu4TX9tQo0jC7w0cu8oZthVjlnhgEANFSRtjTMA4UaYjEgT36ygZ+Lp2PfeP6O5az9X8Ma5lOOmlu8C301d1zvIKH4X+Z9niOhZE+qIyOZojdmqoPCqhTEB54mjK7MgcbjPbNxFViyVLCYhPGltIb5ny478zDbmaS/wFZLXnWuhSC*******/nGaGyXzxUizYYjNd6oG8AD3mAvBjwhKP+c1IKv/yE68G*******uBh5fAhUuJaCwdsoJmkJGSJGR/j3VSdewIydW0YdmLX3upMfCyCbNxv0nOw6Bm7C4Zxdz4ZjaUEt3XD328*******Z0Czy3ihSDAMuRhXV43TsPMzKxRMQMQRPvT2Fz0EwMNsRDgzdBb/8WWdPDoU3m2IoIRN0Rwff0NCNuuZkB9KyLHqDKkj2neABp7HQnu7Af6+/QdlagmEHSDXUEdacJRjAZwvSxrY+83Tivr/BkMa"
}
data原始数据为：
data:[{
    name: "张四",
    entry_time: "2018-01-01",
    employee_status: "实习",
    depart_name: "测试部门",
    id_number: "34******37",
    phone_number: "138****35"
    emergency_phone_number: "13********",
    emergency_relation: "父子",
    emergency_name: "张三",
    emergency_sex: "男",
}]

正常返回值为

{
    "code": null,
    "data": "成功1条",
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取员工列表 action=listEmployee

• 入参

• 返回值

data为JSONArray结构

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "listEmployee",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
 }

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": [
        {
            "birth": "19**-**-**",
            "depart_name": "测试部门",
            "employee_status": "实习",
            "entry_time": "2018-01-01",
            "id": "0*****d38",
            "id_number": "3**96**3",
            "name": "张四",
            "phone_number": "13******11",
            "sex": "男"
        }.....
    ],
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取合同列表 action=getContractListByUser

• 入参

• 返回值

data为JSONArray结构

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "getContractListByUser",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data":"binVVN+sDis9RK4Qh2******PznOIpv4/SDLxYW6DukWTHoC3Ae83Fuft*******YU8cUHyfcsAzEaMKKlpGsjteFA="

}

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": [
         {
         "id": "399bb184-ce79-4eaa-8d8e-f198cbf4a01c",
         "name": "与****劳动合同20200428",
         "start_time": "2020-04-28"
         }.....
    ],
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取合同详情 action=getContractByContractID

• 入参

• 返回值

data为jsonObject结构

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "getContractByContractID",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data":"binVVN+sDis9RK4Qh2******PznOIpv4/SDLxYW6DukWTHoC3Ae83Fuft*******YU8cUHyfcsAzEaMKKlpGsjteFA="

}

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": [
          "data": {
                 "start_time": "2020-04-28",
                 "res_path": "http://****.aliyuncs.com/d7cd*******b03fd7d41b.pdf?Expires=1588****&OSSAccessKeyId=LTAIrKxH7CZ*****oO%2BI%3D",
                 "name": "与梅钧翔的附件2：浙江人力资源协会防疫承诺书20200428"
             },
    ],
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取人员免登陆码 action=avoidLogin

• 入参

• 返回值

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "getContractListByUser",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data":"binVVN+sDis9RK4Qh2******PznOIpv4/SDLxYW6DukWTHoC3Ae83Fuft*******YU8cUHyfcsAzEaMKKlpGsjteFA="

}

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": "ce7557d0-5af6-4b7f-****-8252682fee55"
    "success": true,
    "message": "successful！",
    "status": "default"
}

获取合同签署记录 action=getSignLog

• 入参

• 返回值

data为jsonObject结构

• 请求示例

HTTP请求示例

 GET /openAPI HTTP/1.1
 Host: https://ectcs.hrsecn.com
 Content-Type: application/json
 {
     "action": "getContractByContractID",
     "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
     "data":"binVVN+sDis9RK4Qh2******PznOIpv4/SDLxYW6DukWTHoC3Ae83Fuft*******YU8cUHyfcsAzEaMKKlpGsjteFA="

}

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": [
        {
            "sign_date": "2020-**-** 23:41:52",
            "sign_operator": "陈**",
            "sign_status": "签署"
        }.....
    ],
    "success": true,
    "message": "successful！",
    "status": "default"
}

免登陆码有效性校验 action=checkAvoidLogin

• 入参

data为jsonObject结构

• 返回值

data为jsonObject结构

• 请求示例

HTTP请求示例

GET /openAPI HTTP/1.1
Host: https://ectcs.hrsecn.com
Content-Type: application/json
{
    "action": "checkAvoidLogin",
    "pub_key": "MIGfMA0GCSqGSIb3DQEB*****8pL9xZ+o0YFxDu6ApCvL9e2WhVkwlKMK1K8P*******AFEX6BRtHwXvv81Y*******eeo9xRsousieAM9J+05qy+tGFmQnVWue0f7eLPjKE4pb5hR0658wIDAQAB",
    "data": "Pu4TX9tQo0jC7w0cu8oZthVjlnhgEANFSRtjTMA4UaYjEgT36ygZ+Lp2PfeP6O5az9X8Ma5lOOmlu8C301d1zvIKH4X+Z9niOhZE+qIyOZojdmqoPCqhTEB54mjK7MgcbjPbNxFViyVLCYhPGltIb5ny478zDbmaS/wFZLXnWuhSC*******/nGaGyXzxUizYYjNd6oG8AD3mAvBjwhKP+c1IKv/yE68G*******uBh5fAhUuJaCwdsoJmkJGSJGR/j3VSdewIydW0YdmLX3upMfCyCbNxv0nOw6Bm7C4Zxdz4ZjaUEt3XD328*******Z0Czy3ihSDAMuRhXV43TsPMzKxRMQMQRPvT2Fz0EwMNsRDgzdBb/8WWdPDoU3m2IoIRN0Rwff0NCNuuZkB9KyLHqDKkj2neABp7HQnu7Af6+/QdlagmEHSDXUEdacJRjAZwvSxrY+83Tivr/BkMa"
}
data原始数据为：
data:[{
    id: "06b0133a-c8c2*****b-6895f7f82df3",
    contract: "4ae1c411-1e8a-4d6e*****-934cbd514cbb",
    code: "3ff607db-25c1*****-87f3-5263d5770ee1",
}]

正常返回值为（演示数据经过模糊处理，实际返回为未模糊处理数据）

{
    "code": null,
    "data": {
            id: "06b0133a-c8c2*****b-6895f7f82df3",
            contract: "4ae1c411-1e8a-4d6e*****-934cbd514cbb",
            flag: true
            },
    "success": true,
    "message": "successful！",
    "status": "default"
}

错误信息参考