员工文件上传
接口说明: 上传员工文件、图片信息，一次上传一个文件或图片。上传成功后会返回文件的key。如果需要设置该文件为员工图片类型的字段，可以直接设置文件的key。
由于上传文件的接口比较特殊，需要以 multipart/form-data 的方式请求。所以请求body不再是json格式的字符串。 同时签名规则也有所不同。需要对employeeId和timestamp拼装的字符串进行签名样例:
如果请求的参数为: employeeId=12313&3345IUYsdfsfsfsfsf1231
timestamp=1606212570192.
则需要签名的字符串为: employeeId=12313&3345IUYsdfsfsfsfsfs×tamp=1606212570192
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/file/upload
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
表单参数::
| 参数 | 参数类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| file | File | Y | 上传的文件，不在签名范围内，支持文件格式:jpg/jpeg/png/大小限制10M，pdf/doc/docx/rar/zip大小限制10M |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| date | EmployeeFileUploadResponse | Y | 返回值 |
EmployeeFileUploadResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| key | String | Y | 文件key，用于更新员工对应文件字段 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/file/upload?sign=12431SADDASD&employeeId=123vcwefwwfwfwr32131237×tamp=1606212570192
请求正文:
对应的文件流信息
SDK请求示例(java):
EmployeeFileUploadRequest request = new EmployeeFileUploadRequest(access_token);
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setFileName("2.png");
request.setInputStream(new FileInputStream("C:\\Users\\orange\\Desktop\\2.png"));
OpenapiResponse<EmployeeFileUploadResponse> key = XrxsEmployeeService.uploadEmpFile(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"key": "Aa9Blxyx1Di2QArLv2i8ZGY3MzlmZDVkNzFiZjhlODhlMzRmY2ZiZDE0ZjNmNTAzZjVlOTIxYzU3ZDE5ZjBhZDU1MWJmMmQ3OTg3ZTBiYjNOxWk9Nv6KGn3an0QjFDxmYUWwmLoQjjEElQqpZWj0FaLmrn//iIYVG7q8yfOjuOzfA7uQ7fMLDca7Qg7xWGCgnakP7N6XtGa3UaxqOKa01B83eAvkmIXXveftqsEBLbEkwslvRwUWv7olldot1/yrRB8nYACA6s1TqGIDqpzEKA=="//文件key
}
}