2011年3月11日 (五) 11:15的版本

微博基础数据接口 (Rest API)

获取下行数据集(timeline)接口

• statuses/public_timeline 获取最新的公共微博消息
• statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博消息 (别名: statuses/home_timeline)
• statuses/user_timeline 获取当前登录用户发布的微博消息列表
• statuses/mentions 获取@当前用户的微博列表
• statuses/comments_timeline 获取当前用户发送及收到的评论列表
• statuses/comments_by_me 获取当前用户发出的评论
• statuses/comments_to_me 获取当前用户收到的评论
• statuses/comments 根据微博消息ID返回某条微博消息的评论列表
• statuses/counts 批量获取一组微博的评论数及转发数
• statuses/repost_timeline 返回一条原创微博的最新n条转发微博信息 New!
• statuses/repost_by_me 返回用户转发的最新n条微博信息 New!
• statuses/unread 获取当前用户未读消息数
• statuses/reset_count 未读消息数清零接口
• emotions 表情接口，获取表情列表

微博访问接口

• statuses/show 根据ID获取单条微博信息内容
• user/statuses/id 根据微博ID和用户ID跳转到单条微博页面
• statuses/update 发布一条微博信息Updated!
• statuses/upload 上传图片并发布一条微博信息
• statuses/destroy 删除一条微博信息
• statuses/repost 转发一条微博信息Updated!
• statuses/comment 对一条微博信息进行评论Updated!
• statuses/comment_destroy/:id 删除当前用户的微博评论信息
• statuses/comment/destroy_batch 批量删除当前用户的微博评论信息
• statuses/reply 回复微博评论信息Updated!

用户接口

• users/show 根据用户ID获取用户资料（授权用户）

• statuses/friends 获取用户关注列表及每个关注用户最新一条微博
• statuses/followers 获取用户粉丝列表及及每个粉丝用户最新一条微博
• users/hot 获取系统推荐用户
• user/friends/update_remark更新当前登录用户所关注的某个好友的备注信息New!
• users/suggestions 返回当前用户可能感兴趣的用户 Beta!

私信接口

• direct_messages 获取当前用户最新私信列表
• direct_messages/sent 获取当前用户发送的最新私信列表
• direct_messages/new 发送一条私信
• direct_messages/destroy/:id 删除一条私信
• direct_messages/destroy_batch 批量删除私信

关注接口

• friendships/create 关注某用户
• friendships/destroy 取消关注
• friendships/exists 是否关注某用户(推荐使用friendships/show)
• friendships/show 获取两个用户关系的详细情况

话题接口Beta!

• trends 获取某人的话题
• trends/statuses 获取某一话题下的微博
• trends/follow 关注某一个话题
• trends/destroy 取消关注的某一个话题
• trends/hourly 按小时返回热门话题
• trends/daily 按日期返回热门话题。返回某一日期的话题
• trends/weekly 按周返回热门话题。返回某一日期之前某一周的话题

Social Graph接口

• friends/ids 获取用户关注对象uid列表
• followers/ids 获取用户粉丝对象uid列表

隐私设置接口[NEW]

• account/update_privacy 设置隐私信息
• account/get_privacy 获取隐私信息

黑名单接口 [NEW]

• blocks/create 将某用户加入黑名单
• blocks/destroy 将某用户移出黑名单
• blocks/exists 检测某用户是否是黑名单用户
• blocks/blocking 列出黑名单用户(输出用户详细信息)
• blocks/blocking/ids 列出分页黑名单用户（只输出id）

用户标签接口[NEW]

• tags 返回指定用户的标签列表
• tags/create 添加用户标签
• tags/suggestions 返回用户感兴趣的标签
• tags/destroy 删除标签
• tags/destroy_batch 批量删除标签

账号接口

• account/verify_credentials 验证当前用户身份是否合法
• account/rate_limit_status 获取当前用户API访问频率限制
• account/end_session 当前用户退出登录
• account/update_profile_image 更改头像
• account/update_profile 更改资料

收藏接口

• favorites 获取当前用户的收藏列表
• favorites/create 添加收藏
• favorites/destroy 删除当前用户收藏的微博信息
• favorites/destroy_batch 批量删除收藏的微博信息

登录/OAuth接口

• oauth OAuth授权方式介绍
• oauth/request_token 获取未授权的Request Token
• oauth/authorize 请求用户授权Token
• oauth/access_token 获取授权过的Access Token

*xAuth xAuth授权方式介绍

微博搜索 API (Search API)

Search API仅对新浪合作开发者开放，申请请联系 @微博开放平台

用户搜索

• users/search 搜索微博用户 (仅对新浪合作开发者开放) Updated!

微博搜索

• search 搜索微博文章 (仅对新浪合作开发者开放)
• statuses/search 搜索微博(多条件组合) (仅对合作开发者开放)

微博地理位置信息API (Location API)

Map API仅对新浪合作开发者开放，有任何问题，请联系 @地理信息开放平台

POI数据搜索接口

• pois/keyword 根据关键字和（或）分类进行搜索，返回相关的poi点信息
• pois/round 根据关键字和（或）分类，在中心点附近搜索，返回相关的poi点信息
• pois/view 根据关键字和（或）分类，在一个矩形里进行搜索，返回相关的poi点信息

地图基础服务

• geocode/ip_to_geo 根据ip返回地理信息
• geocode/address_to_geo 根据地址返回坐标的接口
• geocode/geo_to_address 根据坐标返回地址信息

驾车路线搜索接口

• navigation/route 驾车路线查询

公交接口

• bus/transfer 根据起始id或坐标搜索公交换乘路线
• bus/line 线路名称搜索
• bus/station 公交站点名称搜索

静态地图

• base/get_map_image生成一个静态地图的图片

天气信息

• base/weather 根据城市返回天气信息

意见反馈

• base/feedback 意见反馈接口

测试接口

• help/test 测试接口

附录

Rest API字段说明

• status 微博信息内容
• user 用户资料信息
• comment 评论信息描述
• direct_message 私信信息
• 省份城市编码表
• Metadata 元数据 New!

地理信息字段说明

• location/citycode 城市代码对应表
• location/citycode_bus 公交城市代码表
• location/category 分类代码对应表