API文档 V2
第1行: | 第1行: | ||
− | + | <div class="wiki_kit"> | |
− | < | + | |
− | < | + | <p class="tips_txt">注:点击回到 [[API文档|旧版接口文档]]</p> |
− | <div | + | |
− | [[#微博|微博接口]] | + | <div class="wiki_taglist"> |
− | + | <ul class="clearfix"> | |
− | + | <li>[[#微博|微博接口]]</li> | |
− | [[#评论|评论接口]] | + | <li>[[#评论|评论接口]]</li> |
− | + | <li>[[#用户|用户接口]]</li> | |
− | + | <li>[[#关系|关系接口]]</li> | |
− | [[#用户|用户接口]] | + | <li>[[#账号|账号接口]]</li> |
− | + | <li>[[#收藏|收藏接口]]</li> | |
− | + | <li>[[#话题|话题接口]]</li> | |
− | [[#关系|关系接口]] | + | <li>[[#标签|标签接口]]</li> |
− | + | <li>[[#注册|注册接口]]</li> | |
− | + | <li>[[#搜索|搜索接口]]</li> | |
− | [[#账号|账号接口]] | + | <li>[[#推荐|推荐接口]]</li> |
− | + | <li>[[#提醒|提醒接口]]</li> | |
− | + | <li>[[#公共服务|公共服务接口]]</li> | |
− | [[#收藏|收藏接口]] | + | <li>[[#地理信息|地理信息接口]]</li> |
− | + | </ul> | |
− | + | ||
− | [[#话题|话题接口]] | + | |
− | + | ||
− | + | ||
− | [[#标签|标签接口]] | + | |
− | + | ||
− | + | ||
− | [[#注册|注册接口]] | + | |
− | + | ||
− | + | ||
− | [[#搜索|搜索接口]] | + | |
− | + | ||
− | + | ||
− | [[#推荐|推荐接口]] | + | |
− | + | ||
− | + | ||
− | [[#提醒|提醒接口]] | + | |
− | + | ||
− | + | ||
− | [[#公共服务|公共服务接口]] | + | |
− | + | ||
− | + | ||
− | [[#地理信息|地理信息接口]] | + | |
</div> | </div> | ||
− | |||
− | |||
+ | <p class="tips_txt">标识为 {{Icon_adv}} 的接口为高级权限接口,需要申请才可以调用,申请方式请见 [[高级接口申请]]</p> | ||
− | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | |
+ | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | ||
+ | !colspan="3" scope="col"|<span id="微博">微博</span> | ||
+ | |- | ||
+ | |rowspan="20" style="text-align:center;"|读取接口 | ||
+ | |[[2/statuses/public_timeline|statuses/public_timeline]] | ||
+ | |获取最新的公共微博 | ||
+ | |- | ||
+ | |[[2/statuses/friends_timeline|statuses/friends_timeline]] | ||
+ | |获取当前登录用户及其所关注用户的最新微博 | ||
+ | |- | ||
+ | |[[2/statuses/home_timeline|statuses/home_timeline]] | ||
+ | |获取当前登录用户及其所关注用户的最新微博 | ||
+ | |- | ||
+ | |[[2/statuses/friends_timeline/ids|statuses/friends_timeline/ids]] | ||
+ | |获取当前登录用户及其所关注用户的最新微博的ID | ||
+ | |- | ||
+ | |[[2/statuses/user_timeline|statuses/user_timeline]] | ||
+ | |获取用户发布的微博 | ||
+ | |- | ||
+ | |[[2/statuses/user_timeline/ids|statuses/user_timeline/ids]] | ||
+ | |获取用户发布的微博的ID {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/statuses/repost_timeline|statuses/repost_timeline]] | ||
+ | |返回一条原创微博的最新转发微博 | ||
+ | |- | ||
+ | |[[2/statuses/repost_timeline/ids|statuses/repost_timeline/ids]] | ||
+ | |获取一条原创微博的最新转发微博的ID {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/statuses/repost_by_me|statuses/repost_by_me]] | ||
+ | |返回用户转发的最新微博 | ||
+ | |- | ||
+ | |[[2/statuses/mentions|statuses/mentions]] | ||
+ | |获取@当前用户的最新微博 | ||
+ | |- | ||
+ | |[[2/statuses/mentions/ids|statuses/mentions/ids]] | ||
+ | |获取@当前用户的最新微博的ID {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/statuses/bilateral_timeline|statuses/bilateral_timeline]] | ||
+ | |获取双向关注用户的最新微博 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/statuses/show|statuses/show]] | ||
+ | |根据ID获取单条微博信息 | ||
+ | |- | ||
+ | |[[2/statuses/querymid|statuses/querymid]] | ||
+ | |通过id获取mid | ||
+ | |- | ||
+ | |[[2/statuses/queryid|statuses/queryid]] | ||
+ | |通过mid获取id | ||
+ | |- | ||
+ | |[[2/statuses/hot/repost_daily|statuses/hot/repost_daily]] | ||
+ | |按天返回热门转发榜 | ||
+ | |- | ||
+ | |[[2/statuses/hot/repost_weekly|statuses/hot/repost_weekly]] | ||
+ | |按周返回热门转发榜 | ||
+ | |- | ||
+ | |[[2/statuses/hot/comments_daily|statuses/hot/comments_daily]] | ||
+ | |按天返回热门评论榜 | ||
+ | |- | ||
+ | |[[2/statuses/hot/comments_weekly|statuses/hot/comments_weekly]] | ||
+ | |按周返回热门评论榜 | ||
+ | |- | ||
+ | |[[2/statuses/count|statuses/count]] | ||
+ | |批量获取指定微博的转发数评论数 | ||
+ | |- | ||
+ | |rowspan="6" style="text-align:center;"|写入接口 | ||
+ | |[[2/statuses/repost|statuses/repost]] | ||
+ | |转发一条微博信息 | ||
+ | |- | ||
+ | |[[2/statuses/destroy|statuses/destroy]] | ||
+ | |删除微博信息 | ||
+ | |- | ||
+ | |[[2/statuses/update|statuses/update]] | ||
+ | |发布一条微博信息 | ||
+ | |- | ||
+ | |[[2/statuses/upload|statuses/upload]] | ||
+ | |上传图片并发布一条微博 | ||
+ | |- | ||
+ | |[[2/statuses/upload_url_text|statuses/upload_url_text]] | ||
+ | |发布一条微博同时指定上传的图片或图片url {{Icon_adv}} | ||
+ | |- | ||
+ | |[[2/emotions|emotions]] | ||
+ | |获取官方表情 | ||
+ | |} | ||
+ | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | ||
+ | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | ||
+ | !colspan="3" scope="col"|<span id="评论">评论</span> | ||
+ | |- | ||
+ | |rowspan="6" style="text-align:center;"|读取接口 | ||
+ | |[[2/comments/show|comments/show]] | ||
+ | |获取某条微博的评论列表 | ||
+ | |- | ||
+ | |[[2/comments/by_me|comments/by_me]] | ||
+ | |我发出的评论列表 | ||
+ | |- | ||
+ | |[[2/comments/to_me|comments/to_me]] | ||
+ | |我收到的评论列表 | ||
+ | |- | ||
+ | |[[2/comments/timeline|comments/timeline]] | ||
+ | |获取用户发送及收到的评论列表 | ||
+ | |- | ||
+ | |[[2/comments/mentions|comments/mentions]] | ||
+ | |获取@到我的评论 | ||
+ | |- | ||
+ | |[[2/comments/show_batch|comments/show_batch]] | ||
+ | |批量获取评论内容 | ||
+ | |- | ||
+ | |rowspan="4" style="text-align:center;"|写入接口 | ||
+ | |[[2/comments/create|comments/create]] | ||
+ | |评论一条微博 | ||
+ | |- | ||
+ | |[[2/comments/destroy|comments/destroy]] | ||
+ | |删除一条评论 | ||
+ | |- | ||
+ | |[[2/comments/destroy_batch|comments/destroy_batch]] | ||
+ | |批量删除评论 | ||
+ | |- | ||
+ | |[[2/comments/reply|comments/reply]] | ||
+ | |回复一条微博 | ||
+ | |} | ||
− | == | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | == | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> |
− | + | !colspan="3" scope="col"|<span id="用户">用户</span> | |
− | + | |- | |
− | + | |rowspan="3" style="text-align:center;"|读取接口 | |
− | + | |[[2/users/show|users/show]] | |
− | + | |获取用户信息 {{Icon_new2}} | |
− | + | |- | |
− | + | |[[2/users/domain_show|users/domain_show]] | |
− | + | |通过个性域名获取用户信息 | |
− | + | |- | |
− | + | |[[2/users/counts|users/counts]] | |
− | + | |批量获取用户的粉丝数、关注数、微博数 | |
− | + | |} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
− | + | !colspan="3" scope="col"|<span id="关系">关系</span> | |
− | + | |- | |
− | + | |rowspan="5" style="text-align:center;"|关注读取接口 | |
− | + | |[[2/friendships/friends|friendships/friends]] | |
− | + | |获取用户的关注列表 | |
+ | |- | ||
+ | |[[2/friendships/friends/in_common|friendships/friends/in_common]] | ||
+ | |获取共同关注人列表 | ||
+ | |- | ||
+ | |[[2/friendships/friends/bilateral|friendships/friends/bilateral]] | ||
+ | |获取双向关注列表 | ||
+ | |- | ||
+ | |[[2/friendships/friends/bilateral/ids|friendships/friends/bilateral/ids]] | ||
+ | |获取双向关注UID列表 | ||
+ | |- | ||
+ | |[[2/friendships/friends/ids|friendships/friends/ids]] | ||
+ | |获取用户关注对象UID列表 | ||
+ | |- | ||
+ | |rowspan="3" style="text-align:center;"|粉丝读取接口 | ||
+ | |[[2/friendships/followers|friendships/followers]] | ||
+ | |获取用户粉丝列表 | ||
+ | |- | ||
+ | |[[2/friendships/followers/ids|friendships/followers/ids]] | ||
+ | |获取用户粉丝UID列表 | ||
+ | |- | ||
+ | |[[2/friendships/followers/active|friendships/followers/active]] | ||
+ | |获取用户优质粉丝列表 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|关系链读取接口 | ||
+ | |[[2/friendships/friends_chain/followers|friendships/friends_chain/followers]] | ||
+ | |获取我的关注人中关注了指定用户的人 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|关系读取接口 | ||
+ | |[[2/friendships/show|friendships/show]] | ||
+ | |获取两个用户关系的详细情况 | ||
+ | |- | ||
+ | |rowspan="3" style="text-align:center;"|写入接口 | ||
+ | |[[2/friendships/create|friendships/create]] | ||
+ | |关注某用户 | ||
+ | |- | ||
+ | |[[2/friendships/destroy|friendships/destroy]] | ||
+ | |取消关注某用户 | ||
+ | |- | ||
+ | |[[2/friendships/remark/update|friendships/remark/update]] | ||
+ | |更新关注人备注 {{Icon_adv}} | ||
+ | |} | ||
+ | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | ||
+ | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | ||
+ | !colspan="3" scope="col"|<span id="账号">账号</span> | ||
+ | |- | ||
+ | |rowspan="4" style="text-align:center;"|读取接口 | ||
+ | |[[2/account/get_privacy|account/get_privacy]] | ||
+ | |获取隐私设置信息 | ||
+ | |- | ||
+ | |[[2/account/profile/school_list|account/profile/school_list]] | ||
+ | |获取所有学校列表 | ||
+ | |- | ||
+ | |[[2/account/rate_limit_status|account/rate_limit_status]] | ||
+ | |获取当前用户API访问频率限制 | ||
+ | |- | ||
+ | |[[2/account/get_uid|account/get_uid]] | ||
+ | |OAuth授权之后获取用户UID(作用相当于旧版接口的 [[account/verify_credentials]]) | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|写入接口 | ||
+ | |[[2/account/end_session|account/end_session]] | ||
+ | |退出登录 | ||
+ | |} | ||
− | == | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | === | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> |
− | + | !colspan="3" scope="col"|<span id="收藏">收藏</span> | |
− | + | |- | |
− | + | |rowspan="6" style="text-align:center;"|读取接口 | |
− | + | |[[2/favorites|favorites]] | |
− | + | |获取当前用户的收藏列表 | |
− | + | |- | |
+ | |[[2/favorites/ids|favorites/ids]] | ||
+ | |获取当前用户的收藏列表的ID {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/favorites/show|favorites/show]] | ||
+ | |获取单条收藏信息 | ||
+ | |- | ||
+ | |[[2/favorites/by_tags|favorites/by_tags]] | ||
+ | |获取当前用户某个标签下的收藏列表 | ||
+ | |- | ||
+ | |[[2/favorites/tags|favorites/tags]] | ||
+ | |当前登录用户的收藏标签列表 | ||
+ | |- | ||
+ | |[[2/favorites/by_tags/ids|favorites/by_tags/ids]] | ||
+ | |获取当前用户某个标签下的收藏列表的ID {{Icon_new2}} | ||
+ | |- | ||
+ | |rowspan="6" style="text-align:center;"|写入接口 | ||
+ | |[[2/favorites/create|favorites/create]] | ||
+ | |添加收藏 | ||
+ | |- | ||
+ | |[[2/favorites/destroy|favorites/destroy]] | ||
+ | |删除收藏 | ||
+ | |- | ||
+ | |[[2/favorites/destroy_batch|favorites/destroy_batch]] | ||
+ | |批量删除收藏 | ||
+ | |- | ||
+ | |[[2/favorites/tags/update|favorites/tags/update]] | ||
+ | |更新收藏标签 | ||
+ | |- | ||
+ | |[[2/favorites/tags/update_batch|favorites/tags/update_batch]] | ||
+ | |更新当前用户所有收藏下的指定标签 | ||
+ | |- | ||
+ | |[[2/favorites/tags/destroy_batch|favorites/tags/destroy_batch]] | ||
+ | |删除当前用户所有收藏下的指定标签 | ||
+ | |} | ||
− | === | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
− | + | !colspan="3" scope="col"|<span id="话题">话题</span> | |
− | + | |- | |
− | + | |rowspan="5" style="text-align:center;"|读取接口 | |
+ | |[[2/trends|trends]] | ||
+ | |获取某人话题 | ||
+ | |- | ||
+ | |[[2/trends/is_follow|trends/is_follow]] | ||
+ | |是否关注某话题 | ||
+ | |- | ||
+ | |[[2/trends/hourly|trends/hourly]] | ||
+ | |返回最近一小时内的热门话题 | ||
+ | |- | ||
+ | |[[2/trends/daily|trends/daily]] | ||
+ | |返回最近一天内的热门话题 | ||
+ | |- | ||
+ | |[[2/trends/weekly|trends/weekly]] | ||
+ | |返回最近一周内的热门话题 | ||
+ | |- | ||
+ | |rowspan="2" style="text-align:center;"|写入接口 | ||
+ | |[[2/trends/follow|trends/follow]] | ||
+ | |关注某话题 | ||
+ | |- | ||
+ | |[[2/trends/destroy|trends/destroy]] | ||
+ | |取消关注的某一个话题 | ||
+ | |} | ||
+ | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | ||
+ | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | ||
+ | !colspan="3" scope="col"|<span id="标签">标签</span> | ||
+ | |- | ||
+ | |rowspan="3" style="text-align:center;"|读取接口 | ||
+ | |[[2/tags|tags]] | ||
+ | |返回指定用户的标签列表 | ||
+ | |- | ||
+ | |[[2/tags/tags_batch|tags/tags_batch]] | ||
+ | |批量获取用户标签 | ||
+ | |- | ||
+ | |[[2/tags/suggestions|tags/suggestions]] | ||
+ | |返回系统推荐的标签列表 | ||
+ | |- | ||
+ | |rowspan="3" style="text-align:center;"|写入接口 | ||
+ | |[[2/tags/create|tags/create]] | ||
+ | |添加用户标签 | ||
+ | |- | ||
+ | |[[2/tags/destroy|tags/destroy]] | ||
+ | |删除用户标签 | ||
+ | |- | ||
+ | |[[2/tags/destroy_batch|tags/destroy_batch]] | ||
+ | |批量删除用户标签 | ||
+ | |} | ||
− | == | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | === | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> |
− | + | !colspan="3" scope="col"|<span id="注册">注册</span> | |
− | + | |- | |
− | + | |rowspan="1" style="text-align:center;"|读取接口 | |
+ | |[[2/register/verify_nickname|register/verify_nickname]] | ||
+ | |验证昵称是否可用 | ||
+ | |} | ||
+ | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" | ||
+ | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | ||
+ | !colspan="3" scope="col"|<span id="搜索">搜索</span> | ||
+ | |- | ||
+ | |rowspan="6" style="text-align:center;"|搜索联想接口 | ||
+ | |[[2/search/suggestions/users|search/suggestions/users]] | ||
+ | |搜用户搜索建议 | ||
+ | |- | ||
+ | |[[2/search/suggestions/statuses|search/suggestions/statuses]] | ||
+ | |搜微博搜索建议 | ||
+ | |- | ||
+ | |[[2/search/suggestions/schools|search/suggestions/schools]] | ||
+ | |搜学校搜索建议 | ||
+ | |- | ||
+ | |[[2/search/suggestions/companies|search/suggestions/companies]] | ||
+ | |搜公司搜索建议 | ||
+ | |- | ||
+ | |[[2/search/suggestions/apps|search/suggestions/apps]] | ||
+ | |搜应用搜索建议 | ||
+ | |- | ||
+ | |[[2/search/suggestions/at_users|search/suggestions/at_users]] | ||
+ | |@联想搜索 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|搜索话题接口 | ||
+ | |[[2/search/topics|search/topics]] | ||
+ | |搜索某一话题下的微博 {{Icon_adv}} | ||
+ | |} | ||
− | == | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | === | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> |
− | + | !colspan="3" scope="col"|<span id="推荐">推荐</span> | |
− | + | |- | |
− | + | |rowspan="7" style="text-align:center;"|读取接口 | |
− | + | |[[2/suggestions/users/hot|suggestions/users/hot]] | |
− | + | |获取系统推荐用户 | |
+ | |- | ||
+ | |[[2/suggestions/users/may_interested|suggestions/users/may_interested]] | ||
+ | |获取用户可能感兴趣的人 | ||
+ | |- | ||
+ | |[[2/suggestions/users/by_status|suggestions/users/by_status]] | ||
+ | |根据微博内容推荐用户 | ||
+ | |- | ||
+ | |[[2/suggestions/statuses/hot|suggestions/statuses/hot]] | ||
+ | |获取微博精选推荐 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/suggestions/statuses/reorder|suggestions/statuses/reorder]] | ||
+ | |主Feed微博按兴趣推荐排序 | ||
+ | |- | ||
+ | |[[2/suggestions/statuses/reorder/ids|suggestions/statuses/reorder/ids]] | ||
+ | |主Feed微博按兴趣推荐排序的微博ID | ||
+ | |- | ||
+ | |[[2/suggestions/favorites/hot|suggestions/favorites/hot]] | ||
+ | |热门收藏 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|写入接口 | ||
+ | |[[2/suggestions/users/not_interested|suggestions/users/not_interested]] | ||
+ | |不感兴趣的人 | ||
+ | |} | ||
− | === | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
− | + | !colspan="3" scope="col"|<span id="提醒">提醒</span> | |
− | + | |- | |
+ | |rowspan="1" style="text-align:center;"|读取接口 | ||
+ | |[[2/remind/unread_count|remind/unread_count]] | ||
+ | |获取某个用户的各种消息未读数 {{Icon_new2}} | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|写入接口 | ||
+ | |[[2/remind/set_count|remind/set_count]] | ||
+ | |对当前登录用户某一种消息未读数进行清零 {{Icon_adv}} {{Icon_new2}} | ||
+ | |} | ||
− | === | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
+ | !colspan="3" scope="col"|<span id="公共服务">公共服务</span> | ||
+ | |- | ||
+ | |rowspan="5" style="text-align:center;"|读取接口 | ||
+ | |[[2/common/code_to_location|common/code_to_location]] | ||
+ | |通过地址编码获取地址名称 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/common/get_city|common/get_city]] | ||
+ | |获取城市列表 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/common/get_province|common/get_province]] | ||
+ | |获取省份列表 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/common/get_country|common/get_country]] | ||
+ | |获取国家列表 {{Icon_new2}} | ||
+ | |- | ||
+ | |[[2/common/get_timezone|common/get_timezone]] | ||
+ | |获取时区配置表 {{Icon_new2}} | ||
+ | |} | ||
− | === | + | {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" |
− | + | <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> | |
+ | !colspan="3" scope="col"|<span id="地理信息">地理信息</span> | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|基础位置读取接口 | ||
+ | |[[2/location/base/get_map_image|location/base/get_map_image]] | ||
+ | |生成一张静态的地图图片 | ||
+ | |- | ||
+ | |rowspan="5" style="text-align:center;"|坐标转换接口 | ||
+ | |[[2/location/geo/ip_to_geo|location/geo/ip_to_geo]] | ||
+ | |根据IP地址返回地理信息坐标 | ||
+ | |- | ||
+ | |[[2/location/geo/address_to_geo|location/geo/address_to_geo]] | ||
+ | |根据实际地址返回地理信息坐标 | ||
+ | |- | ||
+ | |[[2/location/geo/geo_to_address|location/geo/geo_to_address]] | ||
+ | |根据地理信息坐标返回实际地址 | ||
+ | |- | ||
+ | |[[2/location/geo/gps_to_offset|location/geo/gps_to_offset]] | ||
+ | |根据GPS坐标获取偏移后的坐标 | ||
+ | |- | ||
+ | |[[2/location/geo/is_domestic|location/geo/is_domestic]] | ||
+ | |判断地理信息坐标是否是国内坐标 | ||
+ | |- | ||
+ | |rowspan="4" style="text-align:center;"|POI数据读取接口 | ||
+ | |[[2/location/pois/show_batch|location/pois/show_batch]] | ||
+ | |批量获取POI点的信息 | ||
+ | |- | ||
+ | |[[2/location/pois/search/by_location|location/pois/search/by_location]] | ||
+ | |根据关键词按地址位置获取POI点的信息 | ||
+ | |- | ||
+ | |[[2/location/pois/search/by_geo|location/pois/search/by_geo]] | ||
+ | |根据关键词按坐标点范围获取POI点的信息 | ||
+ | |- | ||
+ | |[[2/location/pois/search/by_area|location/pois/search/by_area]] | ||
+ | |根据关键词按矩形区域获取POI点的信息 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|POI数据写入接口 | ||
+ | |[[2/location/pois/add|location/pois/add]] | ||
+ | |提交一个新增的POI点信息 | ||
+ | |- | ||
+ | |rowspan="1" style="text-align:center;"|移动服务读取接口 | ||
+ | |[[2/location/mobile/get_location|location/mobile/get_location]] | ||
+ | |根据移动基站WIFI等数据获取当前位置信息 | ||
+ | |- | ||
+ | |rowspan="4" style="text-align:center;"|交通路线读取接口 | ||
+ | |[[2/location/line/drive_route|location/line/drive_route]] | ||
+ | |根据起点与终点数据查询自驾车路线信息 | ||
+ | |- | ||
+ | |[[2/location/line/bus_route|location/line/bus_route]] | ||
+ | |根据起点与终点数据查询公交乘坐路线信息 | ||
+ | |- | ||
+ | |[[2/location/line/bus_line|location/line/bus_line]] | ||
+ | |根据关键词查询公交线路信息 | ||
+ | |- | ||
+ | |[[2/location/line/bus_station|location/line/bus_station]] | ||
+ | |根据关键词查询公交站点信息 | ||
+ | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===地理位置信息接口错误代码及解释=== | ===地理位置信息接口错误代码及解释=== | ||
第274行: | 第500行: | ||
− | + | </div>__NOTOC__ | |
− | __NOTOC__ | + |
2012年3月19日 (一) 17:09的版本
注:点击回到 旧版接口文档
标识为 的接口为高级权限接口,需要申请才可以调用,申请方式请见 高级接口申请
微博 | ||
---|---|---|
读取接口 | statuses/public_timeline | 获取最新的公共微博 |
statuses/friends_timeline | 获取当前登录用户及其所关注用户的最新微博 | |
statuses/home_timeline | 获取当前登录用户及其所关注用户的最新微博 | |
statuses/friends_timeline/ids | 获取当前登录用户及其所关注用户的最新微博的ID | |
statuses/user_timeline | 获取用户发布的微博 | |
statuses/user_timeline/ids | 获取用户发布的微博的ID | |
statuses/repost_timeline | 返回一条原创微博的最新转发微博 | |
statuses/repost_timeline/ids | 获取一条原创微博的最新转发微博的ID | |
statuses/repost_by_me | 返回用户转发的最新微博 | |
statuses/mentions | 获取@当前用户的最新微博 | |
statuses/mentions/ids | 获取@当前用户的最新微博的ID | |
statuses/bilateral_timeline | 获取双向关注用户的最新微博 | |
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/count | 批量获取指定微博的转发数评论数 | |
写入接口 | 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 | 通过个性域名获取用户信息 | |
users/counts | 批量获取用户的粉丝数、关注数、微博数 |
关系 | ||
---|---|---|
关注读取接口 | 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/get_privacy | 获取隐私设置信息 |
account/profile/school_list | 获取所有学校列表 | |
account/rate_limit_status | 获取当前用户API访问频率限制 | |
account/get_uid | OAuth授权之后获取用户UID(作用相当于旧版接口的 account/verify_credentials) | |
写入接口 | account/end_session | 退出登录 |
收藏 | ||
---|---|---|
读取接口 | favorites | 获取当前用户的收藏列表 |
favorites/ids | 获取当前用户的收藏列表的ID | |
favorites/show | 获取单条收藏信息 | |
favorites/by_tags | 获取当前用户某个标签下的收藏列表 | |
favorites/tags | 当前登录用户的收藏标签列表 | |
favorites/by_tags/ids | 获取当前用户某个标签下的收藏列表的ID | |
写入接口 | 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/topics | 搜索某一话题下的微博 |
推荐 | ||
---|---|---|
读取接口 | suggestions/users/hot | 获取系统推荐用户 |
suggestions/users/may_interested | 获取用户可能感兴趣的人 | |
suggestions/users/by_status | 根据微博内容推荐用户 | |
suggestions/statuses/hot | 获取微博精选推荐 | |
suggestions/statuses/reorder | 主Feed微博按兴趣推荐排序 | |
suggestions/statuses/reorder/ids | 主Feed微博按兴趣推荐排序的微博ID | |
suggestions/favorites/hot | 热门收藏 | |
写入接口 | suggestions/users/not_interested | 不感兴趣的人 |
提醒 | ||
---|---|---|
读取接口 | remind/unread_count | 获取某个用户的各种消息未读数 |
写入接口 | remind/set_count | 对当前登录用户某一种消息未读数进行清零 |
公共服务 | ||
---|---|---|
读取接口 | common/code_to_location | 通过地址编码获取地址名称 |
common/get_city | 获取城市列表 | |
common/get_province | 获取省份列表 | |
common/get_country | 获取国家列表 | |
common/get_timezone | 获取时区配置表 |
地理信息 | ||
---|---|---|
基础位置读取接口 | location/base/get_map_image | 生成一张静态的地图图片 |
坐标转换接口 | 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 | 判断地理信息坐标是否是国内坐标 | |
POI数据读取接口 | location/pois/show_batch | 批量获取POI点的信息 |
location/pois/search/by_location | 根据关键词按地址位置获取POI点的信息 | |
location/pois/search/by_geo | 根据关键词按坐标点范围获取POI点的信息 | |
location/pois/search/by_area | 根据关键词按矩形区域获取POI点的信息 | |
POI数据写入接口 | location/pois/add | 提交一个新增的POI点信息 |
移动服务读取接口 | location/mobile/get_location | 根据移动基站WIFI等数据获取当前位置信息 |
交通路线读取接口 | location/line/drive_route | 根据起点与终点数据查询自驾车路线信息 |
location/line/bus_route | 根据起点与终点数据查询公交乘坐路线信息 | |
location/line/bus_line | 根据关键词查询公交线路信息 | |
location/line/bus_station | 根据关键词查询公交站点信息 |
地理位置信息接口错误代码及解释
- location/error2 地理位置信息接口错误代码及解释
OAuth 2.0接口(V2版接口将仅支持OAuth 2.0授权方式)
- oauth2/access_token 获取授权过的Access Token
- oauth2/authorize 请求用户授权Token