移动客户端接入

跳转到: 导航, 搜索

微博已融入到大众日常生活中,且具有用户群体大、粘性高的显著特点。随着网络环境和移动终端功能的不断完善,微博用户随时随地获取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。


为方便移动应用接入微博,微博平台提供了相关接口及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。


官方移动应用SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,使用微博API及平台服务。V3.0版SDK在之前SSO授权、分享、接口封装的基础上,增加了分享推荐功能;增加了封装的分享接口;优化了所有WebView,使第三方应用在登录、分享等功能下,有了更好的用户体验;同时还新增了社会化评论和关注组件。


SDK功能特性

1. 关系升级:

使用官方新版SDK3.0移动应用除了获取同样使用该应用的好友,现在可额外获取约30%的关系链(未使用新版SDK3.0的应用,只能获取同授权该应用的好友关系,这点与facebook和twitter的授权机制相同)


image004.jpg


2. 授权升级:

改进后的SSO授权采用客户端原生实现,整个流程仅需一步,中间没有页面加载,更加快捷,用户手机没有安装微博客户端则使用H5页授权。

image0051-600x308.png

对移动应用提供授权刷新机制,使用微博SDK3.0(及以以上版本)的应用,可获得Refresh Token权限,实现一次授权,更长的有效期,非SDK应用授权将调整到7天。

具体调用方法请参考开发文档: http://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E


3、SSO授权

接入微博的第三方Android、iOS应用可通过微博官方客户端快速完成OAuth2.0授权。 不需要重复输入微博用户名、密码,只需要一步操作,直接点击授权按钮即可完成授权,增强了操作简便性及帐号安全性。


SSO授权目的是简化授权流程,读取当前用户登录在客户端上的身份来实现免登录,只需要点击操作就可以完成新浪帐号在第三方应用登录,降低中间的流失率。


SDK2.0后的授权,更加关注开发者自身的应用安全,客户端无需在本地存储新浪应用的APPSECRET,验证应用需要用到包名和签名(签名仅针对Android);而SDK3.0后的授权页面,顶导采用Native,并在体验上做了较多优化。


SSO授权流程示例图:


sdk72207.png


4、下载推荐

新版SDK3.0中,添加了推荐应用下载模块,第三方应用分享内容至微博,在微博正文页中有几率显示推荐应用下载,点击下载直接跳转到下载页面。


image0012-600x458.png


注意:此模块须使用新版SDK 3.0中集成OpenAPI进行分享,否则将无法显示。

由于该功能尚属测试阶段,则需通过平台工作人员申请实现,请发邮件到:weibo_app@vip.sina.com 提交申请。


5、微博原生分享

提供了原生、H5、API多种分享方式供开发者自由选择,无论用户手机中是否预置微博客户端,用户都能顺利分享。

下图为唤起分享的流程:

sdk72208.png

发布微博后的来源文案:第三方应用


6、LinkCard解析

什么是LinkCard:在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊短链,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。

sdk72211.png


7、社会化组件

新版SDK3.0为开发者提供了社会化原生组件。目前包括关注组件和评论组件。

关注组件:为开发者应用提供微博关注功能的原生组件;

评论组件:为开发者应用提供微博评论功能的原生组件。

iOS/Android分别的详细接入方法参见微博iOS/Android平台SDK文档3.0.0



8、短信注册服务

SDK3.01已经开通短信注册服务,为开发者降低投入成本,为用户降低注册/登陆门槛。 申请邮箱weibo_app@vip.sina.com


image010.png



9、特殊接口权限

平台针对使用SDK3.0(及以上版本)的应用,开放了更多的特殊接口权限;针对使用SDK3.0(及以上版本)的应用,未来平台还会开放更多的特殊权限,提供更好的产品和服务。


下图为对照表格:

%E6%9C%AA%E6%A0%87%E9%A2%98-3.png

SDK版本支持

SDK v3.0已经发布了支持iPhone和Android的版本。

须将你的应用的包名签名信息在平台进行填写注册。

SDK3.0不区分Phone和Pad。Windows Phone请下载SDK v2.0。

SDK下载地址:http://open.weibo.com/wiki/SDK

SDK接入流程

新应用

sdk72205.png


1、注册成为开发者,创建移动应用


sdk72203.png


如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 : http://open.weibo.com/wiki/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97


创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。

sdk72201.png


2、创建应用完成后,可以在“我的应用 - 应用信息”中查看您所创建应用的APPKEY及APPSECRET,请妥善保管您的这些信息,这将 成为您调用微博开放平台各API的身份标志,如下图所示:

khd411.png


3、请在“我的应用 - 应用信息 - 高级信息”中填写您的应用回调页,这样才能使OAuth2.0授权正常进行。如果您的APPSECRET发生泄露,您也可以通过该页面中的重置按钮对其重置,如下图所示:


khd5.jpg


注:通常Mobile Native App没有服务器回调地址,您可以在应用控制台授权回调页处填写平台提供的默认回调页,该页面用户不可见,仅用于获取access token。 OAuth2.0客户端默认回调页:https://api.weibo.com/oauth2/default.html


4、在“我的应用 - 应用信息”填写应用的平台信息

sdk72204.png

这里iPhone应用填写Apple ID和Buddle ID,Android应用填写包名,签名及下载地址。

关于各字段含义在控制台中均有说明。


5、下载并集成对应平台SDK到你的应用中,当您开发完您的应用后,您就可以通过“我的应用”页面提交审核了。只有当您的应用通过审核后,才能在微博中正确显示您的来源地址等。


khd611.png


6、您可以通过“我的应用 – 数据统计”页面查看您的应用的相关统计数据,包括应用统计、接口统计、用户特征统计等信息。


khd6.jpg

已上线应用

sdk72206.png

请直接编辑“我的应用 – 应用信息”补充应用平台信息,改字段修改后立即生效,无需二次审核。

移动应用商务合作

移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:yousheng@staff.weibo.com

移动SDK3.01已经开通短信注册服务,申请邮箱weibo_app@vip.sina.com

SDK常见使用问题

1、应用无法唤起微博客户端

应用无法唤起微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。



文档更新时间: 2017-06-08