接口描述:

  • qiniu模块,七牛云 KODO 直传方式上传。

请求 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. "data": [
  3. {
  4. "create_time": "2018-05-28 23:16:23",
  5. "ext": "png",
  6. "hash": "FsTb_ViY80HaBcUQKFP6iwAZzWy3",
  7. "name": "1.png",
  8. "parent_id": 0,
  9. "pixel": {
  10. "height": 386,
  11. "width": 855
  12. },
  13. "protocol": "qiniu",
  14. "size": 36027,
  15. "status": 200,
  16. "storage_id": 50,
  17. "type": 0,
  18. "update_time": "2018-05-28 23:16:23",
  19. "path": "uploads/files/20180528/6e60853dedfcfdf0.png",
  20. "url": "p2oo9yitf.bkt.clouddn.com/uploads/files/20180528/6e60853dedfcfdf0.png?type=qiniu",
  21. "oss": "careyshop.cn/oss?url="
  22. }
  23. ],
  24. "message": "success",
  25. "status": 200
  26. }

错误响应:

  1. {
  2. "error": "bad token"
  3. }

备注:

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

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

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

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

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

  6. 技术文档请参阅 https://developer.qiniu.com/kodo

  7. 错误响应明细请参阅 https://developer.qiniu.com/kodo/api/3928/error-responses

文档更新时间: 2018-06-20 11:29