上传文件

接口描述

上传文件至伙伴云。使用场景:添加或更新用户头像、工作区封面和添加数据、发表评论时附加的图片、附件。

请求URI

/file

HTTP Method

POST

参数说明

参数名称 是否必填 参数说明
type true 标志该文件的类型,仅可填入:attachment(添加数据、发表评论时附加的图片、附件)
name true 文件名称

响应结果说明

名称 说明
file详细信息 上传成功的文件信息,返回结果参见file实例

请求示例

POST /v2/file HTTP/1.1
Host: api.huoban.com
Content-Type: application/json
Authorization: Bearer {YOUR ACCESS TOKEN}

{
  "type": "attachment",
  "name": "example1.jpg"
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json

{
  "file_id": 1000,
  "name": "文件1",
  "created_on": "enable",
  "size": 2000,
  "created_by": {
    "user_id": 3000,
    "name": "名字",
    "avatar": "http:\/\/f2.huoban.com\/30000\/user_avatar\/40000\/xxx"
  },
  "ref_id": 5000,
  "ref_type": "item",
  "link": {
    "source": "http:\/\/hb-v4-attachment-oss.huoban.com\/xxx",
    "small": "http:\/\/hb-v4-attachment-oss.huoban.com\/xxx",
    "medium": "http:\/\/hb-v4-attachment-oss.huoban.com\/xxx",
    "large": "http:\/\/hb-v4-attachment-oss.huoban.com\/xxx",
    "square": "http:\/\/hb-v4-attachment-oss.huoban.com\/xxx"
  }
}