接口描述:

  • aliyun模块,阿里云 OSS 直传方式上传。

请求 URL:

请求方式:

  • POST

是否授权:

  • 需要授权

请求参数:

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data array [] 返回数组
data 类型 是否返回 描述
parent_id integer 所属资源编号
name string 资源名称(来自于参数x:filename)
ext string 资源后缀
size string 资源大小
pixel array 资源像素,非图片资源则为空
hash string 资源Hash值
path string 资源内部路径(资源标识)
url string 资源外链地址
protocol string 资源协议(模块名)
type integer 资源类型 0=图片 1=附件 2=目录
create_time datetime 创建时间
update_time datetime 更新时间
storage_id integer 资源编号
status integer 是否上传成功 200=成功 其他=失败
oss string OSS调用地址

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": [
  5. {
  6. "parent_id": 0,
  7. "name": "3a220004b7106964.png",
  8. "ext": "png",
  9. "size": 40295,
  10. "pixel": {
  11. "width": 855,
  12. "height": 419
  13. },
  14. "hash": "4D5336213F769F2FC3D93A57F2E3E4ED",
  15. "path": "uploads/files/20180528/3a220004b7106964.png",
  16. "url": "careyshop.oss-cn-hangzhou.aliyuncs.com/uploads/files/20180528/3a220004b7106964.png?type=aliyun",
  17. "protocol": "aliyun",
  18. "type": 0,
  19. "create_time": "2018-05-28 23:20:31",
  20. "update_time": "2018-05-28 23:20:31",
  21. "storage_id": 51,
  22. "status": 200,
  23. "oss": "careyshop.cn/oss?url="
  24. }
  25. ]
  26. }

错误响应:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Error>
  3. <Code>InvalidArgument</Code>
  4. <Message>The callback configuration is not base64 encoded.</Message>
  5. <RequestId>5B0C2EABB47FB8B8E56FF451</RequestId>
  6. <HostId>careyshop.oss-cn-hangzhou.aliyuncs.com</HostId>
  7. <ArgumentName>callback</ArgumentName>
  8. <ArgumentValue>eyJjYWxsYmFja1VybCI6Imh0dHBzOlC9jYXJleXNob3AuY25cL2FwaVwvdjFcL3VwbG9hZFwvbWV0aG9kXC9wdXQudXBsb2FkLmRhdGFcL21vZHVsZVwvYWxpeXVuLmh0bWwiLCJjYWxsYmFja0JvZHkiOiJyZXBsYWNlPSR7eDpyZXBsYWNlfSZwYXJlbnRfaWQ9JHt4OnBhcmVudF9pZH0mZmlsZW5hbWU9JHt4OmZpbGVuYW1lfSZtaW1lPSR7bWltZVR5cGV9JnNpemU9JHtzaXplfSZ3aWR0aD0ke2ltYWdlSW5mby53aWR0aH0maGVpZ2h0PSR7aW1hZ2VJbmZvLmhlaWdodH0mcGF0aD0ke29iamVjdH0maGFzaD0ke2V0YWd9IiwiY2FsbGJhY2tCb2R5VHlwZSI6ImFwcGxpY2F0aW9uXC94LXd3dy1mb3JtLXVybGVuY29kZWQifQ==</ArgumentValue>
  9. </Error>

备注:

  1. 只支持单文件上传,如果需要批量上传请自行循环处理。

  2. 请务必判断数组中的对象status字段是否为200,否则有可能上传失败。

  3. 如上传失败,错误响应是由 OSS 服务商给出,所以和框架的结构会不同。

  4. 在 OSS 的概念中path字段即是存放资源的路径,也是资源的系统标识,所以不要直接拿path做链接。

  5. 直接通过 API 接口获取OSS资源时链接会过长,这时候就可以对方法进行封装再通过参数oss的地址调用。

  6. 技术文档请参阅 https://help.aliyun.com/document_detail/31827.html

  7. 错误响应明细请参阅 https://help.aliyun.com/document_detail/32005.html

文档更新时间: 2018-06-03 01:00