跳转到: 导航, 搜索

移动客户端接入

为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。


SDK功能特性

用微博账号登录


微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。


用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。



对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。


集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)


用微博账号登录的授权流程示例图:



授权机制请参考授权技术说明文档:授权机制


分享到微博


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


原生唤起分享的流程,发布后微博来源显示第三方应用名称。



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



分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。


SDK版本支持

iOS SDK

目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。



Android SDK

目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。



SDK接入流程

新应用

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



如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 :新手指南



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



2、创建应用完成后,可以在“我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台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


已上线应用

sdk72206.png

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


移动应用商务合作

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


SDK常见使用问题

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

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