员工文件下载
接口说明: 根据员工id和文件key下载该员工之前上传的文件。员工详情接口中返回的图片类型的字段都是文件key,可以通过此接口来获取实际的图片信息。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/file/download
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
fileKey | String | Y | 文件key |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
出参说明:
- 正常下载时,消息体为文件流,相应头为对应的文件相关信息
- 获取文件失败时,contentType为application/json,具体返回体说明如下:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
errcode | Integer | Y | 错误编码 |
errmsg | String | Y | 错误描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/file/download?sign=cwyzXRxvXDiGetbidkMvHYJ7TVI%3D
请求body示例:
{
"employeeId": "04577f3277f841248f17d36e2561f642",
"fileKey": "f8nHpyjjTmIkiZ2ceCj+rGY4MzNhOGFhMmMxMTA2N2ZhMTY5NThjMGQzYmE0OWEwZGRiNjg4MTYxMTQyOWQ4ZWMwZjEzMTc5NzM4YWE3ZTI0efRDXcR/KTnFHYkiDodDvFEL+IsZ7NwfBSHXxKpp+nUcRnPlnzK6XJ4pHHfO0CWujaTMpKSZ7rvcUKT5/hvB1piLIuE0OXFFnhzyAD1l4+1+EdcQg9kZtQDz1B97mI/GtIjuCs61uP7H8LrZ99jKPdnb9PjEUCe3evwf8mdeCw==",
"timestamp": 1606361858450
}
SDK请求示例(java):
EmployeeFileDownloadRequest request = new EmployeeFileDownloadRequest(access_token);
request.setEmployeeId("04577f3277f841248f17d36e2561f642");
request.setFileKey("f8nHpyjjTmIkiZ2ceCj+rGY4MzNhOGFhMmMxMTA2N2ZhMTY5NThjMGQzYmE0OWEwZGRiNjg4MTYxMTQyOWQ4ZWMwZjEzMTc5NzM4YWE3ZTI0efRDXcR/KTnFHYkiDodDvFEL+IsZ7NwfBSHXxKpp+nUcRnPlnzK6XJ4pHHfO0CWujaTMpKSZ7rvcUKT5/hvB1piLIuE0OXFFnhzyAD1l4+1+EdcQg9kZtQDz1B97mI/GtIjuCs61uP7H8LrZ99jKPdnb9PjEUCe3evwf8mdeCw==");
InputStream inputStream = XrxsEmployeeService.downloadEmpFile(request);
获取文件失败时,contentType为application/json,具体返回体说明如下: 响应示例:
{
"errcode": 20105,
"errmsg": "文件key对应的文件不存在"
}