|
|
第774行: |
第774行: |
| |授权回收接口,帮助开发者主动取消用户的授权 {{Icon_new2}} | | |授权回收接口,帮助开发者主动取消用户的授权 {{Icon_new2}} |
| |} | | |} |
− |
| |
− | ==API更新日志==
| |
− |
| |
− | 微博开放平台,通常会在每周二晚上上线新的代码到线上环境。
| |
− |
| |
− |
| |
− | 我们会通过微博开放平台的官方微博、问答系统、博客、甚至邮件,通知开发者任何重要的变更,确保开发者了解这些变动及其所带来的影响。同时,我们知道任何细微的变化也可能会影响到开发者及他们的应用,所以我们在下面提供一个不定期更新日志,以便开发者查询。
| |
− |
| |
− |
| |
− | '''2013-06-24'''
| |
− |
| |
− | 自2013年7月2日起,微博开放平台将对用户关系读取、微博内容读取类接口进行升级;为保证您的线上应用正常运营,请在7月2日前对以下接口进行升级;本次升级对微博类客户端和合规的应用没有影响。升级中,遇到任何问题,请私信[http://e.weibo.com/openapi @微博开放平台],感谢您的理解支持!具体调整接口如下:
| |
− |
| |
− | 获取当前登录用户发布的微博消息列表([[2/statuses/user_timeline|2/statuses/user_timeline]] )
| |
− |
| |
− | 获取当前登录用户发布的微博消息ID列表([[2/statuses/user_timeline/ids|2/statuses/user_timeline/ids]] )
| |
− |
| |
− | 获取用户的关注列表([[2/friendships/friends|2/riendships/friends]])
| |
− |
| |
− | 获取共同关注人列表([[2/friendships/friends/in_common|2/friendships/friends/in_common]])
| |
− |
| |
− | 获取双向关注列表([[2/friendships/friends/bilateral|2/friendships/friends/bilateral]])
| |
− |
| |
− | 获取双向关注UID列表([[2/friendships/friends/bilateral/ids|2/friendships/friends/bilateral/ids]])
| |
− |
| |
− | 获取用户关注对象UID列表([[2/friendships/friends/ids|2/friendships/friends/ids]])
| |
− |
| |
− | 获取用户粉丝列表([[2/friendships/followers|2/friendships/followers]])
| |
− |
| |
− | 获取用户粉丝UID列表([[2/friendships/followers/ids|2/friendships/followers/ids]])
| |
− |
| |
− | 获取用户优质粉丝列表([[2/friendships/followers/active|2/friendships/followers/active]])
| |
− |
| |
− |
| |
− | '''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接口,在配置文件写入测试参数即可。
| |