新增员工证照记录

最后更新于:2020-08-21 16:41:22

接口描述

可通过本接口新增员工证照记录

接口调用请求说明

https请求方式:POST

请求地址: https://openapi.ihr360.com/openapi/thirdparty/api/v1/staffs/certificates

请求参数说明

调用前,在请求头信息中必须包含以下2项

Content-Type:application/json;charset=UTF-8

Authorization: Bearer access_token;

例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为:

Content-Type:application/json;charset=UTF-8

Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

请求数据样例:Map<String, List<certificateInfoMap>> key是员工ID(staffId)不可重复,重复会被覆盖,value是证照记录List<Map>

{
"a8367314-d4a0-44c0-83fe-63eafd8cdbdc":[{"certificateName":"英语8级证书","certificateNumber":"9874585214662","certificateType":"BusineseCertificate","certifyingAuthority":"上海市英语机构","dateOfDue":"2025-06-01","dateOfIssue":"2018-06-01","grade":"8级","major":"英语专业","recordDate":"2018-06-02","remark":"这是一个证书的描述","reminderDate":"2018-06-03","reminderType":"证照提醒"},{"certificateName":"日语5级证书","certificateNumber":"987458521466342","certificateType":"BusineseCertificate","certifyingAuthority":"上海市日语机构","dateOfDue":"2025-06-01","dateOfIssue":"2018-06-01","grade":"5级","major":"日语专业","recordDate":"2018-06-02","remark":"这是一个证书的描述","reminderDate":"2018-06-03","reminderType":"证照提醒"}],
"a8367314-d4a0-44c0-83fe-63eafd7okjhy":[{"certificateName":"日语2级证书","certificateNumber":"9874585214662","certificateType":"BusineseCertificate","certifyingAuthority":"上海市日语机构","dateOfDue":"2025-06-01","dateOfIssue":"2018-06-01","grade":"2级","major":"日语专业","recordDate":"2018-06-02","remark":"这是一个日语证书的描述","reminderDate":"2018-06-03","reminderType":"证照提醒"}]
}

请求参数描述

certificateInfoMap中的key取值范围:查询花名册字段信息接口返回的columnName

证照信息属性说明(系统固定字段部分,是否必填根据查询花名册字段信息接口的查询结果来)

参数 类型 是否必须 说明
certificateName String 证照名称
certificateNumber String 证照编号
certificateType String 证照类型(todo:后续提供接口获取)
certifyingAuthority String   发证机构
dateOfIssue DATE 发证日期(格式:yyyy-MM-dd)
dateOfDue DATE   到期日期(格式:yyyy-MM-dd)
grade String   级别
major String   专业
recordDate DATE   备案日期(格式:yyyy-MM-dd)
remark String   描述
reminderDate DATE   提醒日期(格式:yyyy-MM-dd)
reminderType String   提醒类型(固定传:证照提醒)

响应参数描述

参数 类型 说明
data String  
code String 返回码,成功为0
message String 返回信息
errorResult String 错误响应时,返回true, 反之则false

返回数据成功样例

{ "data": true,"code": 0,"message": "OK","errorResult": false}