微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
__TOC__ ==API文档== <div class="wiki_kit"> <p class="tips_txt">注:点击查看 [[V1_To_V2|V1到V2接口迁移指南]],查看 [[API文档|旧版接口文档]]</p> <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> <li>[[#提醒|提醒接口]]</li> <li>[[#短链|短链接口]]</li> <li>[[#通知|通知接口]]</li> <li>[[#公共服务|公共服务接口]]</li> <li>[[#位置服务|位置服务接口]]</li> <li>[[#地理信息|地理信息接口]]</li> <li>[[社交电视|社交电视接口]]</li> <li>[[视频上传|视频上传]]</li> <li>[[#OAuth2|OAuth 2.0授权接口]]</li> <li>[[Map-JS|地图引擎接口]]</li> <li>[[支付接口|支付接口]]</li> </ul> </div> <p class="tips_txt">标识为 {{Icon_adv}} 的接口为高级权限接口,需要申请才可以调用,申请方式请见 [[高级接口申请]]</p> <p class="tips_txt">标识为 {{Icon_scope}} 的接口为需要单独向用户提出SCOPE授权请求的接口,用户单独授权后才可以调用,具体使用方法请见 [[scope]]</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="21" 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/timeline_batch|statuses/timeline_batch]] |批量获取指定的一批用户的微博列表 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/repost_timeline|statuses/repost_timeline]] |返回一条原创微博的最新转发微博 |- |[[2/statuses/repost_timeline/ids|statuses/repost_timeline/ids]] |获取一条原创微博的最新转发微博的ID {{Icon_new2}} |- |[[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/show_batch|statuses/show_batch]] |根据微博ID批量获取微博信息 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/querymid|statuses/querymid]] |通过id获取mid |- |[[2/statuses/queryid|statuses/queryid]] |通过mid获取id |- |[[2/statuses/count|statuses/count]] |批量获取指定微博的转发数评论数 |- |[[2/statuses/to_me|statuses/to_me]] |获取当前登录用户关注的人发给其的定向微博 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/statuses/to_me/ids|statuses/to_me/ids]] |获取当前登录用户关注的人发给其的定向微博ID列表 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/statuses/go|statuses/go]] |根据ID跳转到单条微博页{{Icon_new2}} |- |[[2/emotions|emotions]] |获取官方表情 |- |rowspan="7" style="text-align:center;"|写入接口 |[[2/statuses/repost|statuses/repost]] |转发一条微博信息 |- |[[2/statuses/destroy|statuses/destroy]] |删除微博信息 |- |[[2/statuses/update|statuses/update]] |发布一条微博信息 {{Icon_new2}} |- |[[2/statuses/upload|statuses/upload]] |上传图片并发布一条微博 {{Icon_new2}} |- |[[2/statuses/upload_url_text|statuses/upload_url_text]] |发布一条微博同时指定上传的图片或图片url {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/filter/create|statuses/filter/create]] |屏蔽某条微博 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/mentions/shield|statuses/mentions/shield]] |屏蔽某个@我的微博及后续由其转发引起的@提及 {{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="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="1" style="text-align:center;"|读取接口 |[[2/users/get_top_status|users/get_top_status]] |获取用户主页置顶微博 {{Icon_adv}} {{Icon_new2}} |- |rowspan="2" style="text-align:center;"|写入接口 |[[2/users/set_top_status|users/set_top_status]] |设置用户主页置顶微博 {{Icon_adv}} {{Icon_new2}} |- |[[2/users/cancel_top_status|users/cancel_top_status]] |取消用户主页置顶微博 {{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="6" style="text-align:center;"|关注读取接口 |[[2/friendships/friends|friendships/friends]] |获取用户的关注列表 |- |[[2/friendships/friends/remark_batch|friendships/friends/remark_batch]] |批量获取当前登录用户的关注人的备注信息 {{Icon_adv}} {{Icon_new2}} |- |[[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="4" style="text-align:center;"|写入接口 |[[2/friendships/create|friendships/create]] |关注某用户 |- |[[2/friendships/destroy|friendships/destroy]] |取消关注某用户 |- |[[2/friendships/followers/destroy|friendships/followers/destroy]] |移除当前登录用户的粉丝 {{Icon_adv}} {{Icon_new2}} |- |[[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="10" style="text-align:center;"|读取接口 |[[2/friendships/groups|friendships/groups]] |获取当前登陆用户好友分组列表 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/timeline|friendships/groups/timeline]] |获取某一好友分组的微博列表 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/timeline/ids|friendships/groups/timeline/ids]] |获取某一好友分组的微博ID列表 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members|friendships/groups/members]] |获取某一好友分组下的成员列表 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/ids|friendships/groups/members/ids]] |获取某一好友分组下的成员列表的ID {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/description|friendships/groups/members/description]] |批量取好友分组成员的分组说明 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/is_member|friendships/groups/is_member]] |判断某个用户是否是指定好友分组内的成员 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/listed|friendships/groups/listed]] |批量获取某些用户在指定用户的好友分组中的收录信息 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/show|friendships/groups/show]] |获取某个分组的详细信息 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/show_batch|friendships/groups/show_batch]] |批量获取好友分组的详细信息 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |rowspan="8" style="text-align:center;"|写入接口 |[[2/friendships/groups/create|friendships/groups/create]] |创建好友分组 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/update|friendships/groups/update]] |更新好友分组 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/destroy|friendships/groups/destroy]] |删除好友分组 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/add|friendships/groups/members/add]] |添加关注用户到好友分组 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/add_batch|friendships/groups/members/add_batch]] |批量添加用户到好友分组 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/update|friendships/groups/members/update]] |更新好友分组中成员的分组说明 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/members/destroy|friendships/groups/members/destroy]] |删除好友分组内的关注用户 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[2/friendships/groups/order|friendships/groups/order]] |调整当前登录用户的好友分组顺序 {{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |} {|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/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/profile/email|account/profile/email]] |获取用户的联系邮箱{{Icon_adv}} {{Icon_new2}} {{Icon_scope}} |- |[[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/statuses/tags|statuses/tags]] |获取用户的微博标签列表 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/tags/show_batch|statuses/tags/show_batch]] |批量获取微博标签 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/tag_timeline/ids|statuses/tag_timeline/ids]] |获取用户某个标签的微博ID列表 {{Icon_adv}} {{Icon_new2}} |- |rowspan="4" style="text-align:center;"|写入接口 |[[2/statuses/tags/create|statuses/tags/create]] |创建标签 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/tags/destroy|statuses/tags/destroy]] |删除标签 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/tags/update|statuses/tags/update]] |更新标签 {{Icon_adv}} {{Icon_new2}} |- |[[2/statuses/update_tags|statuses/update_tags]] |更新某个微博的标签 {{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="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="5" style="text-align:center;"|搜索联想接口 |[[2/search/suggestions/users|search/suggestions/users]] |搜用户搜索建议 |- |[[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="6" 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/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="2" style="text-align:center;"|转换接口 |[[2/short_url/shorten|short_url/shorten]] |长链转短链 {{Icon_new2}} |- |[[2/short_url/expand|short_url/expand]] |短链转长链 {{Icon_new2}} |- |rowspan="4" style="text-align:center;"|数据接口 |[[2/short_url/share/counts|short_url/share/counts]] |获取短链接在微博上的微博分享数 {{Icon_new2}} |- |[[2/short_url/share/statuses|short_url/share/statuses]] |获取包含指定单个短链接的最新微博内容 {{Icon_new2}} |- |[[2/short_url/comment/counts|short_url/comment/counts]] |获取短链接在微博上的微博评论数 {{Icon_new2}} |- |[[2/short_url/comment/comments|short_url/comment/comments]] |获取包含指定单个短链接的最新微博评论 {{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/notification/send|notification/send]] |给一个或多个用户发送一条新的状态通知 {{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="6" style="text-align:center;"|动态读取接口 |[[2/place/public_timeline|place/public_timeline]] |获取公共的位置动态 {{Icon_adv}} |- |[[2/place/friends_timeline|place/friends_timeline]] |获取用户好友的位置动态 |- |[[2/place/user_timeline|place/user_timeline]] |获取某个用户的位置动态 |- |[[2/place/poi_timeline|place/poi_timeline]] |获取某个位置地点的动态 |- |[[2/place/nearby_timeline|place/nearby_timeline]] |获取某个位置周边的动态 |- |[[2/place/statuses/show|place/statuses/show]] |获取动态的详情 |- |rowspan="5" style="text-align:center;"|用户读取接口 |[[2/place/users/show|place/users/show]] |获取LBS位置服务内的用户信息 |- |[[2/place/users/checkins|place/users/checkins]] |获取用户签到过的地点列表 |- |[[2/place/users/photos|place/users/photos]] |获取用户的照片列表 |- |[[2/place/users/tips|place/users/tips]] |获取用户的点评列表 |- |[[2/place/users/todos|place/users/todos]] |获取用户的todo列表 {{Icon_adv}} |- |rowspan="6" style="text-align:center;"|地点读取接口 |[[2/place/pois/show|place/pois/show]] |获取地点详情 |- |[[2/place/pois/users|place/pois/users]] |获取在某个地点签到的人的列表 |- |[[2/place/pois/tips|place/pois/tips]] |获取地点点评列表 |- |[[2/place/pois/photos|place/pois/photos]] |获取地点照片列表 |- |[[2/place/pois/search|place/pois/search]] |按省市查询地点 |- |[[2/place/pois/category|place/pois/category]] |获取地点分类 |- |rowspan="4" style="text-align:center;"|附近读取接口 |[[2/place/nearby/pois|place/nearby/pois]] |获取附近地点 |- |[[2/place/nearby/users|place/nearby/users]] |获取附近发位置微博的人 |- |[[2/place/nearby/photos|place/nearby/photos]] |获取附近照片 |- |[[2/place/nearby_users/list|place/nearby_users/list]] |获取附近的人 {{Icon_adv}} |- |rowspan="5" style="text-align:center;"|地点写入接口 |[[2/place/pois/create|place/pois/create]] |添加地点 {{Icon_adv}} |- |[[2/place/pois/add_checkin|place/pois/add_checkin]] |签到 |- |[[2/place/pois/add_photo|place/pois/add_photo]] |添加照片 |- |[[2/place/pois/add_tip|place/pois/add_tip]] |添加点评 |- |[[2/place/pois/add_todo|place/pois/add_todo]] |添加todo {{Icon_adv}} |- |rowspan="2" style="text-align:center;"|附近写入接口 |[[2/place/nearby_users/create|place/nearby_users/create]] |用户添加自己的位置 {{Icon_adv}} |- |[[2/place/nearby_users/destroy|place/nearby_users/destroy]] |用户删除自己的位置 {{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="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="3" style="text-align:center;"|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="2" style="text-align:center;"|POI数据读写接口 |[[2/location/pois/show_batch|location/pois/show_batch]] |批量获取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]] |根据关键词查询公交站点信息 |- |rowspan="4" style="text-align:center;"|地理信息字段说明 |[[location/citycode|location/citycode]] |城市代码对应表 |- |[[location/citycode_bus|location/citycode_bus]] |公交城市代码表 |- |[[location/category|location/category]] |分类代码对应表 |- |[[location/error2|location/error2]] |地理位置信息接口错误代码及解释 |} {|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="OAuth2">OAuth2([[授权机制说明|开发指南]])</span> |- |rowspan="1" style="text-align:center;"|请求授权 |[[oauth2/authorize]] |请求用户授权Token |- |rowspan="1" style="text-align:center;"|获取授权 |[[OAuth2/access_token|oauth2/access_token]] |获取授权过的Access Token |- |rowspan="1" style="text-align:center;"|授权查询 |[[oauth2/get_token_info]] |查询用户access_token的授权相关信息 {{Icon_new2}} |- |rowspan="1" style="text-align:center;"|替换授权 |[[oauth2/get_oauth2_token]] |OAuth1.0的Access Token更换至OAuth2.0的Access Token |- |rowspan="1" style="text-align:center;"|授权回收 |[[Oauth2/revokeoauth2|OAuth2/revokeoauth2]] |授权回收接口,帮助开发者主动取消用户的授权 {{Icon_new2}} |} ==API更新日志== 微博开放平台,通常会在每周二晚上上线新的代码到线上环境。 我们会通过微博开放平台的官方微博、问答系统、博客、甚至邮件,通知开发者任何重要的变更,确保开发者了解这些变动及其所带来的影响。同时,我们知道任何细微的变化也可能会影响到开发者及他们的应用,所以我们在下面提供一个不定期更新日志,以便开发者查询。 '''2013-03-18''' 发布授权回收接口,帮助开发者主动取消用户的授权。详情见:http://t.cn/zYeuB0k '''2013-02-25''' 微博读取接口新增批量获取指定的一批用户的微博列表高级接口([[2/statuses/timeline_batch|2/statuses/timeline_batch]])。 微博读取接口新增根据微博ID批量获取微博信息高级接口([[2/statuses/show_batch|2/statuses/show_batch]])。 关注读取接口新增批量获取当前登录用户的关注人的备注信息高级接口([[2/friendships/friends/remark_batch|2/friendships/friends/remark_batch]])。 关系写入接口移除当前登录用户的粉丝高级接口([[2/friendships/followers/destroy|2/friendships/followers/destroy]])。 '''2013-01-23''' 账号读取接口新增获取用户联系邮箱接口([[2/account/profile/email|2/account/profile/email]]),用于查询授权用户的联系邮箱。 该接口在调用前需用户在Scope授权页同意,才能被用户正常调用。scope详情见:http://t.cn/zl3cCxa '''2012-12-20''' 即日起,微博开放平台将禁止“累计使用人数小于500,000”的应用使用V1接口。迁移指南:http://t.cn/zWTaigK '''2012-12-18''' 获取微博精选推荐接口([[2/suggestions/statuses/hot|2/suggestions/statuses/hot]]),由于数据维护问题,已经下线,不再提供。 '''2012-11-07''' 即日起,使用开发者帐号授权自己的应用的授权(token)有效期延长为5年。 发布授权查询接口([[oauth2/get_token_info|Oauth2/get_token_info]]),用于应用查询已授权用户授权时间、过期时间和scope权限等授权相关信息。 '''2012-11-06''' 热门微博转发榜及评论榜相关接口,由于数据维护问题,已经下线,不再提供。包含: [[2/statuses/hot/repost daily|2/statuses/hot/repost daily]] [[2/statuses/hot/repost weekly|2/statuses/hot/repost weekly]] [[2/statuses/hot/comments daily|2/statuses/hot/comments daily]] [[2/statuses/hot/comments weekly|2/statuses/hot/comments weekly]] '''2012-10-31''' 发布地图引擎接口,包含核心类、基础类、覆盖物类多个可用函数。详情见:http://t.cn/zOZ2top '''2012-10-26''' 发布好友分组读写高级接口,共18个。详情见:http://t.cn/zl3KL83 发布微博标签读写高级接口,共7个。详情见:http://t.cn/zl3KqP9 发布置顶微博读写高级接口,共3个。详情见:http://t.cn/zl3KtJD 微博读取接口新增定向微博高级接口,共2个。详情见:http://t.cn/SvqfWa 微博写入接口新增屏蔽微博高级接口,共2个。详情见:http://t.cn/SvqfWa 用户读取接口新增获取用户等级信息接口,共1个。详情见:http://t.cn/z0s5H7L 好友分组、定向微博接口增加scope功能,具体为这些接口在调用前需用户在授权页同意,才能被用户正常调用。scope详情见:http://t.cn/zl3cCxa '''2012-10-15''' 即日起,微博开放平台将禁止“累计使用人数小于10,000”的应用使用V1接口。迁移指南:http://t.cn/zWTaigK '''2012-08-27''' 即日起,微博开放平台将禁止所有“已通过文案审核,但累计使用人数小于1000”的应用使用V1接口,V2接口文档参考:http://t.cn/aF4zI1 。新版接口迁移指南详细见:http://t.cn/zWTaigK '''2012-08-22''' 发布看点的视频上传接口,详细见:http://t.cn/zl2OSCC '''2012-07-24''' 即日起,微博开放平台将禁止所有“未通过审核的应用”调用V1接口,V2接口文档参考:http://t.cn/aF4zI1 '''2012-06-07''' 发布社交电视接口,包含微博互动读取、微博互动访问、节目相关信息、电视台列表等接口,详细见:http://t.cn/zOFGx8F '''2012-05-28''' 发布基于地理位置服务的LBS开放接口,包含POI数据、签到、点评等一系列功能,详细见:http://t.cn/zOrkcGt '''2012-04-24''' 发布短链开放接口二期,共7个接口,主要为短链数据、分析功能,详细见:http://t.cn/aoCCN1 '''2012-03-22''' 发布短链开放接口一期,共3个接口,主要为短链转换功能,详细见:http://t.cn/aoCCN1 '''2012-03-14''' 发布[[2/remind/set_count|remind/set_count]] 对当前登录用户某一种消息未读数进行清零接口。 '''2012-02-24''' 发布[[2/search/topics|search/topics]] 搜索某一话题下的微博接口,该接口为替换老的话题微博接口的升级版接口。 '''2011-12-28''' 接口[[2/trends/statuses|trends/statuses]],由于数据维护问题,已经下线,不再提供,稍后我们会开放新版的搜索话题接口,该接口功能更强大,更稳定,敬请期待。 '''2011-12-19''' 平台对接口:[[2/friendships/create|friendships/create]] 和 [[2/friendships/destroy|friendships/destroy]] 进行了升级,规范了其错误返回信息,有可能对您的应用产生影响,在此提醒您注意,新的错误返回信息详见:http://t.cn/akamjc '''2011-12-01''' 平台V2版接口,第二批开放接口已经上线并开放,详细接口请见:http://t.cn/aoCCN1 '''2011-11-18''' 发布地图服务接口,location接口可以提供基础的地理、地图服务,详细接口请见:http://t.cn/zOeZRBp '''2011-10-12''' 发布新版接口,新版接口性能更高效,授权机制更安全,详情请见:http://t.cn/aF9Ihs '''2011-08-23''' 未读数提醒升级,现在发微博自己@自己将不再提醒未读,影响接口([[statuses/unread]])。 修复了评论接口([[statuses/comment]])的头像更新Bug,该Bug会引起收评论对象更新头像时,发出的评论中头像没有更新,同时影响的接口还包括微博回复评论接口([[statuses/reply]])。 '''2011-08-16''' 修复了未读数接口([[statuses/unread]])重复计数的bug,该bug会引起新粉丝重复计数。 '''2011-08-09''' 修复了回复评论接口([[statuses/reply]])的bug,该bug会引起回复自己的评论时会有新评论的未读数提醒,同时影响的接口还包括微博评论接口([[statuses/comment]])。 ==接口访问频次权限== 微博接口限制用户每个小时只能请求一定的次数。限制分用户维度和IP维度,详述如下: <b class="W_f14">一、针对一个服务器IP的请求次数限制</b> <span style="color:#FF7D13;">测试授权:</span> **1000次/小时 <span style="color:#FF7D13;">普通授权:</span> **10000次/小时 <span style="color:#FF7D13;">中级授权:</span> **20000次/小时 <span style="color:#FF7D13;">高级授权:</span> **30000次/小时 <span style="color:#FF7D13;">合作授权:</span> **40000次/小时 <b class="W_f14">二、针对一个用户在使用一个应用的请求次数限制</b> <span style="color:#FF7D13;">测试授权:</span> **总限制:单用户每应用 150次/小时 **发微博:单用户每应用 30次/小时 **发评论:单用户每应用 60次/小时 **加关注:单用户每应用 60次/小时 100次/天 <span style="color:#FF7D13;">普通授权:</span> **总限制:单用户每应用 1000次/小时 **发微博:单用户每应用 30次/小时 **发评论:单用户每应用 60次/小时 **加关注:单用户每应用 60次/小时 200次/天 <span style="color:#FF7D13;">中级授权:</span> **总限制:单用户每应用 1500次/小时 **发微博:单用户每应用 60次/小时 **发评论:单用户每应用 120次/小时 **加关注:单用户每应用 120次/小时 300次/天 <span style="color:#FF7D13;">高级授权:</span> **总限制:单用户每应用 2000次/小时 **发微博:单用户每应用 90次/小时 **发评论:单用户每应用 180次/小时 **加关注:单用户每应用 180次/小时 300次/天 <span style="color:#FF7D13;">合作授权:</span> **总限制:单用户每应用 无限制 **发微博:单用户每应用 120次/小时 **发评论:单用户每应用 240次/小时 **加关注:单用户每应用 240次/小时 300次/天 未通过审核的,开发中的应用,将适用测试授权,当应用通过审核成为正式应用,将自动升级为普通授权。 客户端类应用最高可申请至合作伙伴授权(授权有效期90天)级别,网页类应用、网站接入类应用最高可申请至高级授权(授权有效期30天)级别。 当频次权限达到本级别的上限时,可在应用控制台中,接口管理标签下的调用频次选项中进行在线申请。 {{center|http://www.sinaimg.cn/blog/developer/wiki/jkpc01.jpg}} 申请时请详细填写应用的产品介绍、推广策略和改进目标。 {{center|http://www.sinaimg.cn/blog/developer/wiki/jkpc02.jpg}} 申请成功后请等待审核,三个工作日之内反馈结果。 {{center|http://www.sinaimg.cn/blog/developer/wiki/jkpc03.jpg}} <b class="W_f14">三、未通过审核应用的测试账号限制</b> 针对未通过审核的,开发中的应用,我们除了以上的频次限制外,将还有测试账号的额外请求限制。每个未通过审核应用只能授权15个测试账号来请求接口。除此之外的账号通过该应用,都无法请求接口。当应用通过审核,该限制自动取消。 测试账号设置在 <span style="color:#FF7D13;">“我的应用>编辑应用属性>测试账号”</span> 里可以找到。 <div style="display:none;"> <b class="W_f14">需要授权的接口限制</b> 微博平台的<span style="color:#FF7D13;">私信接口、搜索接口</span>默认为限制接口。 </div> <b class="W_f14">四、黑名单</b> 我们希望API调用者都能遵循请求限制,过度频率的调用API会导致你的应用/IP加入黑名单。加入黑名单之后,所有请求都会无任何返回。 <b class="W_f14">五、开发者如何正确面对频率限制</b> 首先微博API技术原理上是一个HTTP轮询(POLLING)协议,不是即时推送(realtime push)协议。因此即使增大刷新频率也无法完全达到即时获得最新信息效果。根据经验,更新频率我们建议2-3分钟/次为宜,API客户端也可提供一个手工刷新按钮,用户可以手工获取最新数据。 API客户端可以智能控制请求频率,比如最近几次更新都没获取到数据情况下可以适当将间隔时间延长。当一小时内剩余次数多时候可以适当将更新加快。当剩余请求数偏小时,客户端通过延长自己的更新频率控制不超过上限。另外要适当留一些空余指标,防止用户手工执行一些操作产生的调用导致超出上限。 *客户端可以通过以下接口查询当前剩余请求数:[[Account/rate_limit_status]] *接口频率限制常见问题请参考 [http://open.weibo.com/qa 微博开放平台问答系统] ==API测试工具== *通过 [http://open.weibo.com/tools/console API测试工具] ,可测试调用新浪微博开放平台所有通用API接口,在配置文件写入测试参数即可。
该页面使用的模板:
模板:Icon adv
(
查看源代码
)
模板:Icon new2
(
查看源代码
)
模板:Icon scope
(
查看源代码
)
返回到
微博API
。
反馈
分享
顶部