云存储接口/接口

关注

关注一条数据

接口描述

关注一条数据

请求URI

/follow/item/:item_id

HTTP Method

POST

参数说明

参数名称 是否必填 参数说明
item_id true 数据ID

响应结果说明

名称 说明

请求示例

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

响应示例

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



取消关注

接口描述

取消关注一条数据

请求URI

/follow/item/:item_id

HTTP Method

DELETE

参数说明

参数名称 是否必填 参数说明
item_id true 数据ID

响应结果说明

名称 说明

请求示例

DELETE /v2/follow/item/:item_id HTTP/1.1
Host: api.huoban.com
Content-Type: application/json
Authorization: Bearer {YOUR ACCESS TOKEN}

响应示例

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



获取关注列表

接口描述

获取一条数据的关注列表

请求URI

/follow/item/:item_id/find

HTTP Method

POST

参数说明

参数名称 是否必填 参数说明
item_id true 数据ID
offset false 限定统计结果返回的偏移量
limit false 限定统计结果返回的数量

响应结果说明

名称 说明
total 根据查询条件查到的数据总条数
follows 结果参见Follow an item接口
follows.created_on 创建时间
follows.user 用户对象，参考user实例

请求示例

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

{
  "limit": 10,
  "offset": 0
}

响应示例

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

{
  "total": 10,
  "follows": [
    {
      "user": {
        "user_id": 1000,
        "name": "名字1",
        "avatar": "http:\/\/f2.huoban.com\/30000\/user_avatar\/40000\/xxx"
      },
      "created_on": "2015-03-30 10:13:30"
    },
    {
      "user": {
        "user_id": 1001,
        "name": "名字2",
        "avatar": "http:\/\/f2.huoban.com\/30000\/user_avatar\/40000\/xxx"
      },
      "created_on": "2015-03-30 10:13:30"
    }
  ]
}