员工文件下载

接口说明: 根据员工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对应的文件不存在"
}
2024 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2024-01-15 15:26:15

results matching ""

    No results matching ""