2010年11月17日 (三) 19:14的版本

合作方接口文档

此部分APIs仅提供给合作方使用。

时间线相关(timeline)接口

• Statuses/public_timeline_带应用判断 返回最新更新的20条微博消息，带应用判断

• Statuses/update_带元数据 发布一条微博信息

• statuses/repost_timeline 返回一条原创微博的最新n条转发微博信息

• statuses/repost_by_me 返回用户转发的最新n条微博信息。

话题接口

• trends 获取某人的话题
• trends/statuses 获取某一话题下的微博

热门话题相关接口

• Trends/hourly 按小时返回热门话题

• Trends/daily 按日期返回热门话题。返回某一日期的话题

• Trends/weekly 按周返回热门话题。返回某一日期之前某一周的话题

用户相关接口

• Users/search_带应用判断 返回关键字匹配的微博用户

• Users/suggestions 返回当前用户可能感兴趣的用户

• account/update_privacy 设置隐私信息

• account/get_privacy 获取隐私信息

• friendships/destroy (升级) 升级移除关注接口

用户标签相关接口

• Tags 返回指定用户的标签列表

• Tags/create 添加用户标签

• Tags/suggestions 返回用户感兴趣的标签

• Tags/destroy 删除标签

• Tags/destroy_batch 批量删除标签

订阅分类(List)接口

• 注：接口描述中的:user为用户UID或者昵称，:list_id为List的ID或者slug，:id为用户UID。

数据

• :user/lists 创建新的订阅分类(List)，每个用户最多20个

• :user/lists 列出用户所有的订阅分类(List)

• :user/lists/:list_id 更新指定的订阅分类(List)

• :user/lists/:list_id 展示特定订阅分类(List)的信息，私有订阅分类(List)只能自己可以访问

• :user/lists/:list_id 删除特定订阅分类(List)

• :user/lists/:list_id/statuses 展示订阅分类(List)成员的最新微博信息

• :user/lists/memberships 列出用户作为成员的所有订阅分类(List)列表

• :user/lists/counts 获取用户的订阅分类(List)、subscriptions、listed数量

• :user/lists/subscriptions 列出用户订阅的所有订阅分类(List)列表

用户

• :user/:list_id/members 返回订阅分类(List)的所有的成员

• :user/:list_id/members 将用户添加到订阅分类(List)中。用户只能将其他用户添加到自己创建的list中

• :user/:list_id/members 将用户从订阅分类(List)中删除

• :user/:list_id/members/:id 判断一个用户是否是特定订阅分类(List)的成员

订阅者

• :user/:list_id/subscribers 返回特定订阅分类(List)的所有订阅者

• :user/:list_id/subscribers 用户订阅特定订阅分类(List)

• :user/:list_id/subscribers 用户取消对订阅分类(List)的订阅

• :user/:list_id/subscribers/:id 判断用户是否订阅特定订阅分类(List)

黑名单相关

• Blocks/create 加黑名单

• Blocks/destroy 删黑名单

• Blocks/exists 检测是否是黑名单用户

• Blocks/blocking 分页黑名单用户(输出用户详细信息)

• Blocks/blocking/ids 分页黑名单用户（只输出id）