注：点击查看 V1到V2接口迁移指南，查看 旧版接口文档

标识为 的接口为高级权限接口，需要申请才可以调用，申请方式请见 高级接口申请

标识为 的接口为需要单独向用户提出SCOPE授权请求的接口，用户单独授权后才可以调用，具体使用方法请见 scope

API更新日志

微博开放平台，通常会在每周二晚上上线新的代码到线上环境。

我们会通过微博开放平台的官方微博、问答系统、博客、甚至邮件，通知开发者任何重要的变更，确保开发者了解这些变动及其所带来的影响。同时，我们知道任何细微的变化也可能会影响到开发者及他们的应用，所以我们在下面提供一个不定期更新日志，以便开发者查询。

2013-03-18

发布授权回收接口，帮助开发者主动取消用户的授权。详情见：http://t.cn/zYeuB0k

2013-02-25

微博读取接口新增批量获取指定的一批用户的微博列表高级接口（2/statuses/timeline_batch）。

微博读取接口新增根据微博ID批量获取微博信息高级接口（2/statuses/show_batch）。

关注读取接口新增批量获取当前登录用户的关注人的备注信息高级接口（2/friendships/friends/remark_batch）。

关系写入接口移除当前登录用户的粉丝高级接口（2/friendships/followers/destroy）。

2013-01-23

账号读取接口新增获取用户联系邮箱接口（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），由于数据维护问题，已经下线，不再提供。

2012-11-07

即日起，使用开发者帐号授权自己的应用的授权（token）有效期延长为5年。

发布授权查询接口（Oauth2/get_token_info），用于应用查询已授权用户授权时间、过期时间和scope权限等授权相关信息。

2012-11-06

热门微博转发榜及评论榜相关接口，由于数据维护问题，已经下线，不再提供。包含：

2/statuses/hot/repost daily

2/statuses/hot/repost weekly

2/statuses/hot/comments daily

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

发布remind/set_count 对当前登录用户某一种消息未读数进行清零接口。

2012-02-24

发布search/topics 搜索某一话题下的微博接口，该接口为替换老的话题微博接口的升级版接口。

2011-12-28

接口trends/statuses，由于数据维护问题，已经下线，不再提供，稍后我们会开放新版的搜索话题接口，该接口功能更强大，更稳定，敬请期待。

2011-12-19

平台对接口：friendships/create 和 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维度，详述如下：

一、针对一个服务器IP的请求次数限制

测试授权：

• • 1000次/小时

普通授权：

• • 10000次/小时

中级授权：

• • 20000次/小时

高级授权：

• • 30000次/小时

合作授权：

• • 40000次/小时

二、针对一个用户在使用一个应用的请求次数限制

测试授权：

• • 总限制：单用户每应用 150次/小时
  • 发微博：单用户每应用 30次/小时
  • 发评论：单用户每应用 60次/小时
  • 加关注：单用户每应用 60次/小时 100次/天

普通授权：

• • 总限制：单用户每应用 1000次/小时
  • 发微博：单用户每应用 30次/小时
  • 发评论：单用户每应用 60次/小时
  • 加关注：单用户每应用 60次/小时 200次/天

中级授权：

• • 总限制：单用户每应用 1500次/小时
  • 发微博：单用户每应用 60次/小时
  • 发评论：单用户每应用 120次/小时
  • 加关注：单用户每应用 120次/小时 300次/天

高级授权：

• • 总限制：单用户每应用 2000次/小时
  • 发微博：单用户每应用 90次/小时
  • 发评论：单用户每应用 180次/小时
  • 加关注：单用户每应用 180次/小时 300次/天

合作授权：

• • 总限制：单用户每应用 无限制
  • 发微博：单用户每应用 120次/小时
  • 发评论：单用户每应用 240次/小时
  • 加关注：单用户每应用 240次/小时 300次/天

未通过审核的，开发中的应用，将适用测试授权，当应用通过审核成为正式应用，将自动升级为普通授权。

客户端类应用最高可申请至合作伙伴授权（授权有效期90天）级别，网页类应用、网站接入类应用最高可申请至高级授权（授权有效期30天）级别。

当频次权限达到本级别的上限时，可在应用控制台中，接口管理标签下的调用频次选项中进行在线申请。

申请时请详细填写应用的产品介绍、推广策略和改进目标。

申请成功后请等待审核，三个工作日之内反馈结果。

三、未通过审核应用的测试账号限制

针对未通过审核的，开发中的应用，我们除了以上的频次限制外，将还有测试账号的额外请求限制。每个未通过审核应用只能授权15个测试账号来请求接口。除此之外的账号通过该应用，都无法请求接口。当应用通过审核，该限制自动取消。

测试账号设置在 “我的应用>编辑应用属性>测试账号” 里可以找到。

四、黑名单

我们希望API调用者都能遵循请求限制，过度频率的调用API会导致你的应用/IP加入黑名单。加入黑名单之后，所有请求都会无任何返回。

五、开发者如何正确面对频率限制

首先微博API技术原理上是一个HTTP轮询(POLLING)协议，不是即时推送(realtime push)协议。因此即使增大刷新频率也无法完全达到即时获得最新信息效果。根据经验，更新频率我们建议2-3分钟/次为宜，API客户端也可提供一个手工刷新按钮，用户可以手工获取最新数据。

API客户端可以智能控制请求频率，比如最近几次更新都没获取到数据情况下可以适当将间隔时间延长。当一小时内剩余次数多时候可以适当将更新加快。当剩余请求数偏小时，客户端通过延长自己的更新频率控制不超过上限。另外要适当留一些空余指标，防止用户手工执行一些操作产生的调用导致超出上限。

• 客户端可以通过以下接口查询当前剩余请求数：Account/rate_limit_status

• 接口频率限制常见问题请参考 微博开放平台问答系统

API测试工具

• 通过 API测试工具 ，可测试调用新浪微博开放平台所有通用API接口,在配置文件写入测试参数即可。

新版接口迁移指南

迁移指南PDF下载：新版接口迁移指南V0.1.pdf

一、为什么要迁移到新版接口

• 全新的新版（V2）接口较旧版（V1）接口具有更丰富的功能、更高效、更规范、更可控等优势，很好地满足了开发者的需求。

• V1接口使用的OAuth1.0授权方式无法适应进一步的开放，已被各大开放平台弃用，由全新的OAuth2.0授权方式取代。

新版接口较旧版接口的优势

• 1、更多功能
  • a）V2较V1新增了大量接口，增强的关系接口、搜索话题接口、短链接口、热门微博接口、位置服务接口、通知接口、通用
    • 服务接口、社交电视接口；
  • b）另外，SCOPE授权功能、好友分组接口、邀请接口、社交化接口、表态接口也即将开放。

• 2、更高效
  • a）微博、评论、用户等返回值增加trim开关，按需返回数据，减少冗余数据占用带宽，适应移动应用特点；
  • b）微博评论、转发数可以随微博返回值直接返回，无需额外调用接口，减轻程序负担；
  • c）用户返回值增加互粉好友数、是否关注我、是否被我关注等信息，直观地体现用户关系；
  • d）timeline类接口未来将全部增加筛选过滤功能（feature）和应用隔离功能（base_app），可按应用需要筛选和隔离消息流。

• 3、更规范
  • a）统一参数、返回值字段，全部小写字母，单词和单词之间用“_”链接；
  • b）接口URI，全部采用：域+版本号+资源类+接口名+返回值格式+参数；
  • c）核心字段：微博、评论、用户、关系全部标准化，避免核心字段在不同接口中返回值不同，从而降低开发成本；
  • d）统一的新错误返回值格式及错误码，V2错误码地址：http://open.weibo.com/wiki/Error_code。

• 4、更可控
  • a）将接口分为两级权限：普通、高级，使高级功能接口的权限控制更清晰、透明；
  • b）添加了接口授权管理控制台：接口可以分组打包，并对应用开放授权及接口级别的申请，缩减申请流程。

V1禁止调用时间

• 1、2012年7月24日，禁止所有“未审核应用”调用V1接口；
• 2、2012年8月27日，禁止所有用户量在1000以下的“已审核应用”调用V1接口（已审核Xweibo应用暂时不受影响）；
• 3、2012年10月初左右，禁止所有应用调用V1接口，具体时间请关注@微博开放平台 。
• 4、2012年12月20日，禁止“累计使用人数小于500,000”的应用使用V1接口。

• 禁止调用V1接口的应用在调用V1接口时会返回：“40109 Oauth Error: consumer_key_refused! ” 错误提示。

• V1接口将在近期全面下线，本文为所有仍使用V1接口的已审核应用提供迁移引导，帮助您更快地完成迁移。

二、迁移中常见问题

• 1、Xweibo组件及应用如何过度到V2版？
  • Xweibo已审核上线应用在10月左右暂时不受影响，需要积极配合Xweibo官方提示进行相应的升级。请关注Xweibo官网：http://x.weibo.com 。

• 2、V1中的私信及获取用户信息接口为什么不开放？
  • 私信及涉及隐私的用户信息接口被大量应用滥用，导致大量用户投诉，给平台的开放造成了非常恶劣影响，出于对用户隐私的保护，平台决定不再开放此类导致用户信息泄漏的接口。

• 3、OAuth2.0授权需要申请吗？
  • OAuth2.0授权无需申请，任何应用都可以使用。
  • 需要额外申请的是授权有效期或客户端验证授权。授权有效期可在应用控制台，接口管理标签下的授权机制选项中进行在线申请，客户端验证授权申请方式参见第二个问题。

• 4、怎么申请客户端的验证授权（Resource Owner Password Credentials）方式？
  • 因为OAuth2.0的客户端验证授权会获得用户明文密码，所以实行有限开放。

• • 申请条件：
  • a）应用分类属于桌面客户端、手机客户端。
  • b）应用本身已经通过开放平台文案、广场审核，并在广场上展示超过15天。
  • c）应用使用人数在30000以上。
  • d）应用本身功能与新浪微博关联紧密。

• • 满足条件后在应用控制台的“接口管理”-->“授权机制”中申请。

• 5、手机客户端、PC客户端应用是否需要设置回调页？
  • 需要，使用Web应用的验证授权(Authorization Code)方式的客户端也需要设置授权回调页或绑定域名，在程序中以webview的方式进行调用授权页面返回code，具体实现参考相应的客户端SDK：http://open.weibo.com/wiki/SDK。

• 6、如何查询应用的access_token有效期是多少？
  • a）桌面客户端、手机客户端类应用，测试：1天、尽审核：7天、审核后并上广场展示后：90天。
  • b）非客户端类应用，测试1天、普通7天、中级15天、高级30天、合作90天。

• 7、如何申请延长应用的access_token有效期？
  • a）桌面客户端、手机客户端类应用，未审核应用在应用控制台申请审核通过后7天，如需要达到90天有效期，审核通过后
    • 在申请广场审核。
  • b）非客户端类应用，未审核应用在应用控制台申请审核通过后为普通级别7天， 如需申请更高级别，在应用控制台“接口管
    • 理”-->“调用频次”中进行申请。

• 8、如何计算某个用户的access_token过期时间？
  • a）用户授权时，oauth2/access_token接口返回的expires_in（单位：秒）值就是access_token的生命周期。
  • b）从上述对应表中，找到应用所对应的授权有效期，过期时间 = 用户授权时间 + 授权有效期。

• • 应用的授权有效期可以访问接口访问权限说明或在应用控制台查看。

• 9、access_token过期后怎么处理？
  • access_token过期调用接口时，平台会返回错误码为21332的错误，此时需要引导用户重新进行授权。建议在每次获得用户授权时保存过期时间，在每次调用接口前判断用户access_token是否过期。

• • 引导已授权用户再次授权时，如果此用户为已登录新浪微博状态，则授权页面为“一闪而过”无需用户再点击“授权”按钮，如果想让用户重新登录授权，则在调用authorize接口是传入参数：forcelogin=true，默认不填（授权页一闪而过）此参数相当于forcelogin=false。

• 10、已上线应用如何进行本地测试？
  • a）应用不含高级权限或高级接口，建议申请一个普通的Appkey进行本地测试；
  • b）应用含高级接口或高级权限，可以考虑绑定hosts指向本地测试代码进行测试。
    • 例如：应用redirect_uri为：http://aa.abc.com/index.php ，而对应的本地地址为http://127.0.0.1/index.php，则您可
      • 以将测试机hosts绑定成：127.0.0.1 aa.abc.com 。

• 11、如何将已授权用户从OAuth1.0过度到OAuth2.0授权？
  • 应用授权方式从OAuth1.0迁移到OAuth2.0时，应用的授权用户总数不变，以下是进行用户过度的两个建议：
  • a）直接上线OAuth2.0授权版本，OAuth2.0获取access_token时返回用户的uid，根据此uid判断该用户为老用户或新用
    • 户，新增或更新数据库中用户access_token等信息；
  • b）使用get_oauth2_token接口换取OAuth2.0的access_token，此方法可以免去用户对OAuth2.0第一次授权，适当延长过
    • 度OAuth2.0的时间以完成a）的实现（对于授权有效期较长或客户端类应用可以考虑此方法）。

• • • 注意：做批量换取是需谨慎，同一个OAuth1.0的Access Token只能换取一次(多次调用将返回同一个token)，过期时间
      • • 从第一次换取的时候计算。

• 12、迁移时是否需要添加测试帐号？
  • a）测试帐号仅对未审核应用限制，如果您的应用在V1时已经审核通过，则无需添加测试用户。
  • b）如果您使用了未审核的Appkey进行测试，需要您在应用或网站控制台“应用信息”或“网站信息”-->“测试帐号”中添加测试帐
    • 号，未审核应用只有应用创建者与测试帐号才能调用接口。

• 13、V2版接口返回值为什么仅支持JSON格式不支持XML格式返回？
  • a）接口返回值中可能会含有html等字段，采用XML格式返回时需要对html进行特殊处理，直接影响到平台包装返回值及开
    • 发者解析返回值的效率；
  • b）对于JS等语言在解析复杂的XML难度较高，效率较低；
  • c）XML格式较JSON采用Key-Value的形式有很大冗余，不符合手机客户端等对性能要求较高的应用需求。

• 14、有哪些高级接口，怎么申请新版高级接口？
  • 在V2接口文档中接口名称后标注着： 图标则表示此接口为高级接口。高级接口申请要求应用需要通过文案审核，并无作恶情况发生。其他要求及申请流程见：高级接口申请指南。

• 15、阅读完迁移指南后仍有问题怎么办？
  • a）通过开放平台问答系统快速获得帮助；
  • b）将问题通过评论的方式发送到@微博API 与迁移相关的微博下，我们将一一解答。

• 其他问题详见：接口问题FAQ。

三、V1到V2怎么迁移

• V1迁移到V2主要需要完成OAuth1.0到OAuth2.0的过度及完成V1原有接口与V2中新接口的对应替换。

迁移时需要完成的工作

• 1、授权方式的迁移，OAuth1.0升级到OAuth2.0；
• 2、阅读迁移注意事项及常见问题解决建议；
• 3、新旧接口的迁移，接口调用地址、调用方式、参数、返回值、错误信息处理的代码改造。

OAuth1.0升级到OAuth2.0

• 1、OAuth2.0简述
  • OAuth2.0是较OAuth1.0更简单更安全的授权方式，同时支持Web，桌面和移动应用。是未来新浪微博开放平台最主要的用户身份验证和授权方式。

• 2、迁移前准备
  • 请先阅读OAuth2.0开发指南。
  • OAuth2.0授权方式与OAuth1.0相比，引入授权回调页与绑定域名，简化了授权流程，同时也提升了授权的安全性。

• • 在实现OAuth2.0授权方式前，针对不同的应用我们需要设置应用的授权回调页或进行域名的绑定，用于获得授权成功后返回的code，再通过code获取access_token。

• • 使用开发者帐号登录http://open.weibo.com，进入“我的应用”控制台需要迁移的应用进行设置：
  • a）网站接入类
    • 点击控制台导航“网站信息”，在网站基本信息中查看网站域名。如果您的网站应用还未验证所有权，会提示您进行所有权验证，点击进入验证页面完成所有权验证。Web应用请参考：Web应用迁移指引 。

• • • 注意：验证时填写的网站域名即为您的应用的绑定域名。

• • b）站内应用
    • 站内应用已经是OAuth2.0授权方式，无需做改动。

• • c）客户端应用 & 其他应用
    • 点击控制台导航“应用信息”—> “高级信息”，进行授权回调页或域名的绑定。设置回调页不需要二审，方便您进行测试开发。绑定域名需要进行二审，二审时线上应用不受影响，绑定域名增加应用的安全性，同时该域名下的所有页面都可作为授权回调页。

• • • 注意：客户端也需要设置授权回调页或绑定域名，在程序中以webview的方式进行调用授权页面返回code，具体实现可
      • • 以参考：移动应用迁移指引 。 其他客户端可以参考相应SDK：http://open.weibo.com/wiki/SDK 。

• 3、OAuth2.0授权实现
  • 主要流程（请先阅读OAuth2.0开发指南）：

• • a）引导需要授权的用户访问如下地址

• • • https://api.weibo.com/oauth2/authorize?client_id=YOUR_APP_KEY&response_type=code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI ；

• • • 注意：redirect_uri必须为绑定域名下网页或设置的回调地址。

• • b）如果用户同意授权,页面跳转至 YOUR_REGISTERED_REDIRECT_URI/?code=CODE

• • • 注意：每次返回的code值都是不一样的且在换取access_token后失效。

• • c）使用code换取access_token

• • • https://api.weibo.com/oauth2/access_token?client_id=YOUR_APP_KEY&client_secret=YOUR_APP_SECRET&grant_type=authorization_code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&code=CODE ；

• • • 注意：必须使用POST方式提交，其中client_id=YOUR_APP_KEY&client_secret=YOUR_APP_SECRET可以使用
      • • basic方式加入header中。

• • d）返回值
    • {"access_token":"SlAV32hkKG","remind_in":"3600","expires_in":3600,"uid":"1902538057"}
    • 注意：OAuth2.0的access_token较OAuth1.0具有一定的有效期，当access_token过期时需要引导用户重新授权。应用
      • • 的授权有效期可以访问接口访问权限说明或在应用控制台查看。

• • e）使用获得的OAuth2.0 Access Token调用API
    • 读取接口一般使用GET方式提交，如：
    • 接口：statuses/home_timeline
    • 调用：https://api.weibo.com/2/statuses/home_timeline.json?access_token=SlAV32hkKG&count=20 ；

• • • 写入接口必须使用POST方式提交，如：
    • 接口：statuses/upload
    • 调用：https://upload.api.weibo.com/2/statuses/upload.json

• • • 注意：参数信息放入header及body中，除access_token外，其他参数必须放入body中请求。
    • upload请求消息体举例：

• • • • => Send header, 301 bytes (0x12d)
      • POST /2/statuses/upload.json HTTP/1.1
      • User-Agent: curl/7.19.4 (i586-pc-mingw32msvc) libcurl/7.19.4 Ope
      • nSSL/0.9.8g zlib/1.2.3
      • Host: upload.api.weibo.com
      • Accept: */*
      • Content-Length: 38694
      • Expect: 100-continue
      • Content-Type: multipart/form-data; boundary=--------------------
      • --------8933e7b00565

• • • • <= Recv header, 23 bytes (0x17)
      • HTTP/1.1 100 Continue
      • => Send data, 370 bytes (0x172)
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="access_token"

• • • • 2.00RQs9XCmlEQDD4fb4b0bfe3Be7ZQE
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="status"

• • • • Test02
      • ------------------------------8933e7b00565
      • Content-Disposition: form-data; name="pic"; filename="psu.jpg"
      • Content-Type: image/jpeg

四、V1接口迁移到V2接口

• 在实现OAuth2.0授权后，接下来需要将应用使用的V1版接口对应迁移到V2版接口。此时需要根据新接口的调用地址、调用方式、参数、返回值、错误信息处理来进行代码的改造。

• 以下是V2版接口与V1版接口的对应列表，部分旧版接口由于用户投诉或性能等原因已不再提供，同时新版接口提供丰富的高级接口开放优质应用申请，您可以直接在应用控制台中提交高级接口申请。

• 此外，SCOPE授权功能、好友分组接口、邀请接口、社交化等接口已经在平台开放计划中，我们将在保证功能、性能及稳定性后适时开放，详细的开放日期请您关注@微博API。
• 如果现有接口未能满足您的需求，欢迎@微博API进行反馈，我们将根据开发者需求强度及微博用户利益权衡适度开放。