API文档 V2
(→读取接口) |
|||
| 第15行： | 第15行： | ||
[[#关系|关系接口]] | [[#关系|关系接口]] | ||
</div> | </div> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<div style="width:120px;height:25px;background:#E2EEF6;float:left;margin:0 15px 10px 0;padding-top:3px;text-align:center;"> | <div style="width:120px;height:25px;background:#E2EEF6;float:left;margin:0 15px 10px 0;padding-top:3px;text-align:center;"> | ||
[[#账号|账号接口]] | [[#账号|账号接口]] | ||
| 第44行： | 第36行： | ||
[[#推荐|推荐接口]] | [[#推荐|推荐接口]] | ||
</div> | </div> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
<div style="width:120px;height:25px;background:#E2EEF6;float:left;margin:0 15px 10px 0;padding-top:3px;text-align:center;"> | <div style="width:120px;height:25px;background:#E2EEF6;float:left;margin:0 15px 10px 0;padding-top:3px;text-align:center;"> | ||
[[#地理信息|地理信息接口]] | [[#地理信息|地理信息接口]] | ||
| 第68行： | 第52行： | ||
*[[2/statuses/home_timeline|statuses/home_timeline]] 获取当前登录用户及其所关注用户的最新微博 | *[[2/statuses/home_timeline|statuses/home_timeline]] 获取当前登录用户及其所关注用户的最新微博 | ||
*[[2/statuses/user_timeline|statuses/user_timeline]] 获取用户发布的微博 | *[[2/statuses/user_timeline|statuses/user_timeline]] 获取用户发布的微博 | ||
| − | |||
*[[2/statuses/repost_timeline|statuses/repost_timeline]] 返回一条原创微博的最新转发微博 | *[[2/statuses/repost_timeline|statuses/repost_timeline]] 返回一条原创微博的最新转发微博 | ||
*[[2/statuses/repost_by_me|statuses/repost_by_me]] 返回用户转发的最新微博 | *[[2/statuses/repost_by_me|statuses/repost_by_me]] 返回用户转发的最新微博 | ||
*[[2/statuses/mentions|statuses/mentions]] 获取@当前用户的最新微博 | *[[2/statuses/mentions|statuses/mentions]] 获取@当前用户的最新微博 | ||
*[[2/statuses/show|statuses/show]] 根据ID获取单条微博信息 | *[[2/statuses/show|statuses/show]] 根据ID获取单条微博信息 | ||
| − | |||
*[[2/statuses/querymid|statuses/querymid]] 通过id获取mid | *[[2/statuses/querymid|statuses/querymid]] 通过id获取mid | ||
*[[2/statuses/queryid|statuses/queryid]] 通过mid获取id | *[[2/statuses/queryid|statuses/queryid]] 通过mid获取id | ||
| 第88行： | 第70行： | ||
*[[2/statuses/upload_url_text|statuses/upload_url_text]] 发布一条微博同时指定上传的图片或图片url {{Icon_adv}} | *[[2/statuses/upload_url_text|statuses/upload_url_text]] 发布一条微博同时指定上传的图片或图片url {{Icon_adv}} | ||
*[[2/emotions|emotions]] 获取官方表情 | *[[2/emotions|emotions]] 获取官方表情 | ||
| + | |||
==评论== | ==评论== | ||
| 第109行： | 第92行： | ||
*[[2/users/show|users/show]] 获取用户信息 | *[[2/users/show|users/show]] 获取用户信息 | ||
*[[2/users/domain_show|users/domain_show]] 通过个性域名获取用户信息 | *[[2/users/domain_show|users/domain_show]] 通过个性域名获取用户信息 | ||
| − | + | ||
==关系== | ==关系== | ||
| 第118行： | 第101行： | ||
*[[2/friendships/friends/bilateral/ids|friendships/friends/bilateral/ids]] 获取双向关注UID列表 | *[[2/friendships/friends/bilateral/ids|friendships/friends/bilateral/ids]] 获取双向关注UID列表 | ||
*[[2/friendships/friends/ids|friendships/friends/ids]] 获取用户关注对象UID列表 | *[[2/friendships/friends/ids|friendships/friends/ids]] 获取用户关注对象UID列表 | ||
| − | |||
===粉丝读取接口=== | ===粉丝读取接口=== | ||
| 第133行： | 第115行： | ||
===写入接口=== | ===写入接口=== | ||
*[[2/friendships/create|friendships/create]] 关注某用户 | *[[2/friendships/create|friendships/create]] 关注某用户 | ||
| − | |||
*[[2/friendships/destroy|friendships/destroy]] 取消关注某用户 | *[[2/friendships/destroy|friendships/destroy]] 取消关注某用户 | ||
*[[2/friendships/remark/update|friendships/remark/update]] 更新关注人备注 {{Icon_adv}} | *[[2/friendships/remark/update|friendships/remark/update]] 更新关注人备注 {{Icon_adv}} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| 第164行： | 第123行： | ||
*[[2/account/profile/basic|account/profile/basic]] 获取用户基本信息 {{Icon_adv}} | *[[2/account/profile/basic|account/profile/basic]] 获取用户基本信息 {{Icon_adv}} | ||
*[[2/account/profile/education|account/profile/education]] 获取教育信息 {{Icon_adv}} | *[[2/account/profile/education|account/profile/education]] 获取教育信息 {{Icon_adv}} | ||
| − | |||
*[[2/account/profile/career|account/profile/career]] 获取职业信息 {{Icon_adv}} | *[[2/account/profile/career|account/profile/career]] 获取职业信息 {{Icon_adv}} | ||
| − | |||
*[[2/account/get_privacy|account/get_privacy]] 获取隐私设置信息 | *[[2/account/get_privacy|account/get_privacy]] 获取隐私设置信息 | ||
*[[2/account/profile/school_list|account/profile/school_list]] 获取所有学校列表 | *[[2/account/profile/school_list|account/profile/school_list]] 获取所有学校列表 | ||
| 第236行： | 第193行： | ||
*[[2/search/suggestions/apps|search/suggestions/apps]] 搜应用搜索建议 | *[[2/search/suggestions/apps|search/suggestions/apps]] 搜应用搜索建议 | ||
*[[2/search/suggestions/at_users|search/suggestions/at_users]] @联想搜索 | *[[2/search/suggestions/at_users|search/suggestions/at_users]] @联想搜索 | ||
| − | |||
===搜索内容接口=== | ===搜索内容接口=== | ||
*[[2/search/statuses|search/statuses]] 微博搜索 {{Icon_adv}} | *[[2/search/statuses|search/statuses]] 微博搜索 {{Icon_adv}} | ||
| − | |||
===搜索用户接口=== | ===搜索用户接口=== | ||
| 第255行： | 第210行： | ||
===写入接口=== | ===写入接口=== | ||
*[[2/suggestions/users/not_interested|suggestions/users/not_interested]] 不感兴趣的人 | *[[2/suggestions/users/not_interested|suggestions/users/not_interested]] 不感兴趣的人 | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
2011年12月1日 (四) 10:35的版本
注：点击回到旧版接口文档
标识为“高”的接口为高级权限接口，需要申请才可以调用，申请方式请见高级接口申请
微博
读取接口
- statuses/public_timeline 获取最新的公共微博
- statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博
- statuses/home_timeline 获取当前登录用户及其所关注用户的最新微博
- statuses/user_timeline 获取用户发布的微博
- statuses/repost_timeline 返回一条原创微博的最新转发微博
- statuses/repost_by_me 返回用户转发的最新微博
- statuses/mentions 获取@当前用户的最新微博
- statuses/show 根据ID获取单条微博信息
- statuses/querymid 通过id获取mid
- statuses/queryid 通过mid获取id
- statuses/hot/repost_daily 按天返回热门转发榜
- statuses/hot/repost_weekly 按周返回热门转发榜
- statuses/hot/comments_daily 按天返回热门评论榜
- statuses/hot/comments_weekly 按周返回热门评论榜
写入接口
- statuses/repost 转发一条微博信息
- statuses/destroy 删除微博信息
- statuses/update 发布一条微博信息
- statuses/upload 上传图片并发布一条微博
- statuses/upload_url_text 发布一条微博同时指定上传的图片或图片url
- emotions 获取官方表情
评论
读取接口
- comments/show 获取某条微博的评论列表
- comments/by_me 我发出的评论列表
- comments/to_me 我收到的评论列表
- comments/timeline 获取用户发送及收到的评论列表
- comments/mentions 获取@到我的评论
- comments/show_batch 批量获取评论内容
写入接口
- comments/create 评论一条微博
- comments/destroy 删除一条评论
- comments/destroy_batch 批量删除评论
- comments/reply 回复一条微博
用户
读取接口
- users/show 获取用户信息
- users/domain_show 通过个性域名获取用户信息
关系
关注读取接口
- friendships/friends 获取用户的关注列表
- friendships/friends/in_common 获取共同关注人列表
- friendships/friends/bilateral 获取双向关注列表
- friendships/friends/bilateral/ids 获取双向关注UID列表
- friendships/friends/ids 获取用户关注对象UID列表
粉丝读取接口
- friendships/followers 获取用户粉丝列表
- friendships/followers/ids 获取用户粉丝UID列表
- friendships/followers/active 获取用户优质粉丝列表
关系链读取接口
- friendships/friends_chain/followers 获取我的关注人中关注了指定用户的人
关系状态读取接口
- friendships/show 获取两个用户关系的详细情况
写入接口
- friendships/create 关注某用户
- friendships/destroy 取消关注某用户
- friendships/remark/update 更新关注人备注
账号
读取接口
- account/profile/basic 获取用户基本信息
- account/profile/education 获取教育信息
- account/profile/career 获取职业信息
- account/get_privacy 获取隐私设置信息
- account/profile/school_list 获取所有学校列表
- account/rate_limit_status 获取当前用户API访问频率限制
- account/get_uid OAuth授权之后获取用户UID（作用相当于旧版接口的 account/verify_credentials）
写入接口
- account/profile/basic_update 更新用户基本信息
- account/profile/edu_update 更新用户教育信息
- account/profile/edu_destroy 删除用户教育信息
- account/profile/car_update 更新用户职业信息
- account/profile/car_destroy 删除用户职业信息
- account/avatar/upload 上传头像
- account/update_privacy 更新隐私设置
收藏
读取接口
- favorites 获取当前用户的收藏列表
- favorites/show 获取单条收藏信息
- favorites/by_tags 获取当前用户某个标签下的收藏列表
- favorites/tags 当前登录用户的收藏标签列表
写入接口
- favorites/create 添加收藏
- favorites/destroy 删除收藏
- favorites/destroy_batch 批量删除收藏
- favorites/tags/update 更新收藏标签
- favorites/tags/update_batch 更新当前用户所有收藏下的指定标签
- favorites/tags/destroy_batch 删除当前用户所有收藏下的指定标签
话题
读取接口
- trends 获取某人话题
- trends/is_follow 是否关注某话题
- trends/hourly 返回最近一小时内的热门话题
- trends/daily 返回最近一天内的热门话题
- trends/weekly 返回最近一周内的热门话题
写入接口
- trends/follow 关注某话题
- trends/destroy 取消关注的某一个话题
标签
读取接口
- tags 返回指定用户的标签列表
- tags/tags_batch 批量获取用户标签
- tags/suggestions 返回系统推荐的标签列表
写入接口
- tags/create 添加用户标签
- tags/destroy 删除用户标签
- tags/destroy_batch 批量删除用户标签
注册
读取接口
- register/verify_nickname 验证昵称是否可用
搜索
搜索联想接口
- search/suggestions/users 搜用户搜索建议
- search/suggestions/statuses 搜微博搜索建议
- search/suggestions/schools 搜学校搜索建议
- search/suggestions/companies 搜公司搜索建议
- search/suggestions/apps 搜应用搜索建议
- search/suggestions/at_users @联想搜索
搜索内容接口
- search/statuses 微博搜索
搜索用户接口
- search/users 搜索用户
推荐
读取接口
- suggestions/users/hot 获取系统推荐用户
- suggestions/users/may_interested 获取用户可能感兴趣的人
- suggestions/users/by_status 根据微博内容推荐用户
- suggestions/favorites/hot 热门收藏
写入接口
地理信息
坐标转换接口
- location/geo/ip_to_geo 根据IP地址返回地理信息坐标
- location/geo/address_to_geo 根据实际地址返回地理信息坐标
- location/geo/geo_to_address 根据地理信息坐标返回实际地址
- location/geo/gps_to_offset 根据GPS坐标获取偏移后的坐标
- location/geo/is_domestic 判断地理信息坐标是否是国内坐标
OAuth 2.0接口（V2版接口将仅支持OAuth 2.0授权方式）
- oauth2/access_token 获取授权过的Access Token
- oauth2/authorize 请求用户授权Token
