2011年5月26日 (四) 20:38的版本

API Beta

以下接口处在beta测试阶段。您可以试用尝鲜，欢迎您反馈在试用过程中遇到的问题。

订阅分类(List)接口

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

• List接口分两种：开放，私有，私有的List就是目前主站上的关注分组功能，共有的List是一个用户创建的用户集，其他用户可以直接关注这个用户集来达到查看用户集中所有用户的更新。

分类数据

• :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)

应用通知接口

• notice/:uid/unread 获取当前用户未读通知数

• notice/:uid/list 获取当前用户收到的最新n条通知

• notice/send_list 获取当前应用发送的最新n条通知

• notice/app/send 发送单条第三方应用通知接口

应用勋章接口

• badges 查看用户获得的勋章列表
• badges/show 获取一个勋章的详细信息

xAuth

• xAuth xAuth使用说明。
• OAuth使用说明 OAuth使用说明

用户接口

• users/domain_show 通过个性域名获取用户信息

• users/batch_show 批量获取用户基本信息

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

关系接口

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

• statuses/magic_followers 获取用户优质粉丝列表，每次最多返回20条，包括用户的最新的微博

微博接口

• statuses/batch_show 批量获取指定微博

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

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

• statuses/batch_timeline 批量获取指定的一批用户timeline

带图片的微博接口

• statuses/upload_pic

• statuses/upload_url_text

私信接口

• direct_messages/userlist 私信用户列表

话题接口

• trends/is_follow 用户是否关注某话题

账号接口

• account/register 注册新浪微博帐号

• account/activate 二次注册微博的接口

• account/verify_credentials 判断是否是微博帐号

• account/get_notice 获取用户提醒设置

• account/update_notice更新用户提醒设置

热门排行相关接口

• statuses/hot/repost_daily 按天返回热门转发

• statuses/hot/repost_weekly 按周返回热门转发

• statuses/hot/comments_daily 按天返回热门评论

• statuses/hot/comments_weekly 按周返回热门评论

举报接口

• report_spam 提交举报信息

搜索接口

• search/geo/statuses 搜索指定范围内的微博
• search/geo/users 搜索指定范围内的用户