微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
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="4" style="text-align:center;"|读取接口 |[[2/users/show|users/show]] |获取用户信息 {{Icon_new2}} |- |[[2/users/domain_show|users/domain_show]] |通过个性域名获取用户信息 |- |[[2/users/counts|users/counts]] |批量获取用户的粉丝数、关注数、微博数 |- |[[2/users/show_rank|users/show_rank]] |获取用户等级信息 {{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/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="8" style="text-align:center;"|数据接口 |[[2/short_url/clicks|short_url/clicks]] |获取短链接的总点击数 {{Icon_adv}} {{Icon_new2}} |- |[[2/short_url/referers|short_url/referers]] |获取一个短链接点击的referer来源和数量 {{Icon_adv}} {{Icon_new2}} |- |[[2/short_url/locations|short_url/locations]] |获取一个短链接点击的地区来源和数量 {{Icon_adv}} {{Icon_new2}} |- |[[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}} |- |[[2/short_url/info|short_url/info]] |批量获取短链接的富内容信息 {{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="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接口,在配置文件写入测试参数即可。 ==新版接口迁移指南== 迁移指南PDF下载:[http://vdisk.weibo.com/s/gPuMG 新版接口迁移指南V0.1.pdf] <b class="W_f14">一、为什么要迁移到新版接口</b> *全新的新版(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错误码地址:[[Error_code|http://open.weibo.com/wiki/Error_code]]。 *4、更可控 **a)将接口分为两级权限:普通、高级,使高级功能接口的权限控制更清晰、透明; **b)添加了[http://open.weibo.com/apps 接口授权管理控制台]:接口可以分组打包,并对应用开放授权及接口级别的申请,缩减申请流程。 '''V1禁止调用时间''' *1、2012年7月24日,禁止所有“未审核应用”调用V1接口; *2、2012年8月27日,禁止所有用户量在1000以下的“已审核应用”调用V1接口(已审核[http://x.weibo.com Xweibo]应用暂时不受影响); *3、2012年10月初左右,禁止所有应用调用V1接口,具体时间请关注[http://e.weibo.com/openapi @微博开放平台 ]。 *4、2012年12月20日,禁止“累计使用人数小于500,000”的应用使用V1接口。 *禁止调用V1接口的应用在调用V1接口时会返回:“40109 Oauth Error: consumer_key_refused! ” 错误提示。 *V1接口将在近期全面下线,本文为所有仍使用V1接口的已审核应用提供迁移引导,帮助您更快地完成迁移。 <b class="W_f14">二、迁移中常见问题</b> *1、Xweibo组件及应用如何过度到V2版? **[http://x.weibo.com Xweibo]已审核上线应用在10月左右暂时不受影响,需要积极配合[http://x.weibo.com 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)从上述对应表中,找到应用所对应的授权有效期,过期时间 = 用户授权时间 + 授权有效期。 **应用的授权有效期可以访问[[Rate-limiting |接口访问权限说明]]或在[http://open.weibo.com/apps 应用控制台]查看。 *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://aa.abc.com/index.php] ,而对应的本地地址为[http://127.0.0.1/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、有哪些高级接口,怎么申请新版高级接口? **在[[API文档_V2|V2接口文档]]中接口名称后标注着:{{Icon_adv}} 图标则表示此接口为高级接口。高级接口申请要求应用需要通过文案审核,并无作恶情况发生。其他要求及申请流程见:[[高级接口申请|高级接口申请指南]]。 *15、阅读完迁移指南后仍有问题怎么办? ** a)通过[http://open.weibo.com/qa 开放平台问答系统]快速获得帮助; ** b)将问题通过评论的方式发送到[http://e.weibo.com/u/1870632073 @微博API] 与迁移相关的微博下,我们将一一解答。 *其他问题详见:[[ 接口问题|接口问题FAQ]]。 <b class="W_f14">三、V1到V2怎么迁移</b> *V1迁移到V2主要需要完成OAuth1.0到[[授权机制说明|OAuth2.0]]的过度及完成V1原有接口与V2中新接口的对应替换。 '''迁移时需要完成的工作''' *1、授权方式的迁移,OAuth1.0升级到[[授权机制说明|OAuth2.0]]; *2、阅读迁移注意事项及常见问题解决建议; *3、新旧接口的迁移,接口调用地址、调用方式、参数、返回值、错误信息处理的代码改造。 <b class="W_f14">OAuth1.0升级到OAuth2.0</b> *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 http://open.weibo.com],进入“我的应用”控制台需要迁移的应用进行设置: **a)网站接入类 ***点击控制台导航“网站信息”,在网站基本信息中查看网站域名。如果您的网站应用还未验证所有权,会提示您进行所有权验证,点击进入验证页面完成所有权验证。Web应用请参考:[[V1_To_V2/web|Web应用迁移指引]] 。 ***注意:验证时填写的网站域名即为您的应用的绑定域名。 **b)站内应用 ***站内应用已经是[[授权机制说明|OAuth2.0]]授权方式,无需做改动。 **c)客户端应用 & 其他应用 ***点击控制台导航“应用信息”—> “高级信息”,进行授权回调页或域名的绑定。设置回调页不需要二审,方便您进行测试开发。绑定域名需要进行二审,二审时线上应用不受影响,绑定域名增加应用的安全性,同时该域名下的所有页面都可作为授权回调页。 ***注意:客户端也需要设置授权回调页或绑定域名,在程序中以webview的方式进行调用授权页面返回code,具体实现可 *****以参考:[[V1_To_V2/mobile|移动应用迁移指引]] 。 其他客户端可以参考相应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过期时需要引导用户重新授权。应用 *****的授权有效期可以访问[[Rate-limiting |接口访问权限说明]]或在[http://open.weibo.com/apps 应用控制台]查看。 **e)使用获得的OAuth2.0 Access Token调用API ***读取接口一般使用GET方式提交,如: ***接口:[[2/statuses/home_timeline|statuses/home_timeline]] ***调用:https://api.weibo.com/2/statuses/home_timeline.json?access_token=SlAV32hkKG&count=20 ; ***写入接口必须使用POST方式提交,如: ***接口:[[2/statuses/upload|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 <b class="W_f14">四、V1接口迁移到V2接口</b> *在实现[[授权机制说明|OAuth2.0]]授权后,接下来需要将应用使用的V1版接口对应迁移到V2版接口。此时需要根据新接口的调用地址、调用方式、参数、返回值、错误信息处理来进行代码的改造。 *以下是V2版接口与V1版接口的对应列表,部分旧版接口由于用户投诉或性能等原因已不再提供,同时新版接口提供丰富的高级接口开放优质应用申请,您可以直接在应用控制台中提交高级接口申请。 *此外,SCOPE授权功能、好友分组接口、邀请接口、社交化等接口已经在平台开放计划中,我们将在保证功能、性能及稳定性后适时开放,详细的开放日期请您关注[http://weibo.com/u/1870632073 @微博API]。 *如果现有接口未能满足您的需求,欢迎[http://weibo.com/u/1870632073 @微博API]进行反馈,我们将根据开发者需求强度及微博用户利益权衡适度开放。 <div class="wiki_kit"> {|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> |- |style="text-align:center; width: 31%"|新版V2接口 |style="text-align:center;"|对应老版V1接口 |style="text-align:center;"|接口名称 |- |[[2/statuses/public_timeline|statuses/public_timeline]] |[[statuses/public_timeline|statuses/public_timeline]] |获取最新的公共微博 |- |[[2/statuses/friends_timeline|statuses/friends_timeline]] |[[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]] |[[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]] |[[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]] |[[statuses/repost_by_me|statuses/repost_by_me]] |返回用户转发的最新微博 |- |[[2/statuses/mentions|statuses/mentions]] |[[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]] |[[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]] |[[statuses/counts |statuses/counts ]] |批量获取指定微博的转发数评论数 |- |[[2/statuses/repost|statuses/repost]] |[[statuses/repost|statuses/repost]] |转发一条微博信息 |- |[[2/statuses/destroy|statuses/destroy]] |[[statuses/destroy|statuses/destroy]] |删除微博信息 |- |[[2/statuses/update|statuses/update]] |[[statuses/update|statuses/update]] |发布一条微博信息 |- |[[2/statuses/upload|statuses/upload]] |[[statuses/upload |statuses/upload ]] |上传图片并发布一条微博 |- |[[2/statuses/upload_url_text|statuses/upload_url_text]] | |发布一条微博同时指定上传的图片或图片url {{Icon_adv}} |- |[[2/emotions|emotions]] |[[emotions|emotions]] |获取官方表情 |- |[[2/comments/show|comments/show]] |[[statuses/comments|statuses/comments]] |获取某条微博的评论列表 |- |[[2/comments/by_me|comments/by_me]] |[[statuses/comments_by_me|statuses/comments_by_me]] |我发出的评论列表 |- |[[2/comments/to_me|comments/to_me]] |[[statuses/comments_to_me|statuses/comments_to_me]] |我收到的评论列表 |- |[[2/comments/timeline|comments/timeline]] |[[statuses/comments_timeline|statuses/comments_timeline]] |获取用户发送及收到的评论列表 |- |[[2/comments/mentions|comments/mentions]] | |获取@到我的评论 |- |[[2/comments/show_batch|comments/show_batch]] | |批量获取评论内容 |- |[[2/comments/create|comments/create]] |[[statuses/comment|statuses/comment]] |评论一条微博 |- |[[2/comments/destroy|comments/destroy]] |[[statuses/comment_destroy|statuses/comment_destroy/:id]] |删除一条评论 |- |[[2/comments/destroy_batch|comments/destroy_batch]] |[[statuses/comment/destroy_batch|statuses/comment/destroy_batch]] |批量删除评论 |- |[[2/comments/reply|comments/reply]] |[[statuses/reply|statuses/reply]] |回复一条评论 |- |[[2/users/show|users/show]] |[[users/show|users/show]] |获取用户信息 {{Icon_new2}} |- |[[2/users/domain_show|users/domain_show]] | |通过个性域名获取用户信息 |- |[[2/users/counts|users/counts]] | |批量获取用户的粉丝数、关注数、微博数 |- |[[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]] |[[friends/ids|friends/ids]] |获取用户关注对象UID列表 |- |[[2/friendships/followers|friendships/followers]] |[[friendships/show|friendships/show]]、[[friendships/exists|friendships/exists]] |获取用户粉丝列表 |- |[[2/friendships/followers/ids|friendships/followers/ids]] |[[followers/ids|followers/ids]] |获取用户粉丝UID列表 |- |[[2/friendships/followers/active|friendships/followers/active]] | |获取用户优质粉丝列表 |- |[[2/friendships/friends_chain/followers|friendships/friends_chain/followers]] | |获取我的关注人中关注了指定用户的人 |- |[[2/friendships/show|friendships/show]] |[[friendships/exists|friendships/exists]] |获取两个用户关系的详细情况 |- |[[2/friendships/create|friendships/create]] |[[friendships/create|friendships/create]] |关注某用户 |- |[[2/friendships/destroy|friendships/destroy]] |[[friendships/destroy|friendships/destroy]] |取消关注某用户 |- |[[2/friendships/remark/update|friendships/remark/update]] |[[user/friends/update_remark|user/friends/update_remark]] |更新关注人备注 {{Icon_adv}} |- |[[2/account/get_privacy|account/get_privacy]] |[[account/get_privacy|account/get_privacy]] |获取隐私设置信息 |- |[[2/account/profile/school_list|account/profile/school_list]] | |获取所有学校列表 |- |[[2/account/rate_limit_status|account/rate_limit_status]] |[[account/rate_limit_status|account/rate_limit_status]] |获取当前用户API访问频率限制 |- |[[2/account/get_uid|account/get_uid]] |[[account/verify_credentials|account/verify_credentials]] |OAuth授权之后获取用户UID(作用相当于旧版接口的 [[account/verify_credentials]]) |- |[[2/account/end_session|account/end_session]] |[[account/end_session|account/end_session]] |退出登录 |- |[[2/favorites|favorites]] |[[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}} |- |[[2/favorites/create|favorites/create]] |[[favorites/create|favorites/create]] |添加收藏 |- |[[2/favorites/destroy|favorites/destroy]] |[[favorites/destroy|favorites/destroy]] |删除收藏 |- |[[2/favorites/destroy_batch|favorites/destroy_batch]] |[[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]] | |删除当前用户所有收藏下的指定标签 |- |[[2/trends|trends]] |[[trends|trends]] |获取某人话题 |- |[[2/trends/is_follow|trends/is_follow]] | |是否关注某话题 |- |[[2/trends/hourly|trends/hourly]] |[[trends/hourly|trends/hourly]] |返回最近一小时内的热门话题 |- |[[2/trends/daily|trends/daily]] |[[trends/daily|trends/daily]] |返回最近一天内的热门话题 |- |[[2/tren
该页面使用的模板:
模板:Icon adv
(
查看源代码
)
模板:Icon new2
(
查看源代码
)
模板:Icon scope
(
查看源代码
)
返回到
微博API
。
反馈
分享
顶部