移动客户端接入

跳转到: 导航, 搜索
(如何申请Appkey)
第1行: 第1行:
=为什么接入新浪微博=
+
新浪微博已经融入到用户日常生活当中,且具有用户群体庞大、用户粘性高的显著特点。随着网络环境和移动终端功能的不断完善,微博用户随时随地获取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。为方便移动应用接入新浪微博,微博平台提供了相关接口及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。
新浪微博经过两年的发展已经融入到大量手机用户生活当中,且具有用户群体庞大、用户粘性高的显著特点。随着网络环境和移动终端功能的不断优化,微博用户随时随地读取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。为方便移动应用接入新浪微博功能,手机微博平台提供了相关接口以及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化的升级服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。
+
  
=客户端接入流程=
 
==如何申请Appkey==
 
  
 +
官方移动应用SDK,竭在方便移动应用开发者更快捷地接入新浪微博开放平台,使用微博API及平台服务。V2.1版SDK在之前SSO授权,接口封装的基础上,增强了对官方微博客户端的开放,使第三方应用具备调用发博,集成至附件栏等功能模块。
  
;1、在浏览器中打开新浪微博开放平台:http://open.weibo.com  登录您的微博帐号后进入应用开发版块,点击创建应用,如下图:
 
  
 +
=SDK功能特性=
 +
1、SSO授权
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd1.jpg}}
+
接入新浪微博的第三方Android、iOS应用可通过新浪微博官方客户端快速完成OAuth2.0授权。
 +
不需要重复输入新浪微博用户名、密码,只需要一步操作,直接点击授权按钮即可完成授权,增强了操作简便性及帐号安全性。
  
  
;2、在按下创建应用后弹出的页面中,注意选择“客户端”类型,如下图:
+
SSO授权目的是简化授权流程,读取当前用户登录在客户端上的身份来实现免登录,只需要点击操作就可以完成新浪帐号在第三方应用登录,降低中间的流失率。
  
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd.png}}
+
SSO授权升级至2.0后,更加关注开发者自身的应用安全,客户端无需在本地存储新浪应用的APPSECRET,验证应用需要用到包名和签名(签名仅针对Android)。
  
  
;3、选择客户端之后,在新打开的页面中输入所需创建应用的基本信息。注意选择正确的应用分类:客户端 - 手机,以便我们提供
+
SSO授权流程示例图:
*给您更多针对性的服务,如下图所示:
+
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72207.png}}
  
 +
 +
2、微博原生分享
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd311.png}}
+
原生分享(Native Share),既通过调用官方微博客户端的发博器,来实现发送微博的功能。
  
  
;4、创建应用完成后,可以在“我的应用 – 应用信息”中查看您所创建应用的AppKey及AppSecret,请妥善保管您的这些信息,这将
+
当前支持两种形式:唤起分享和集成分享。
*成为您调用新浪微博开放平台各API的身份标志,如下图所示:
+
  
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
+
a) 唤起分享:从第三方应用选择内容分享到微博
  
  
;5、请在“我的应用 – 应用信息 – 高级信息”中填写您的应用回调页,这样才能使OAuth2.0授权正常进行。如果您的AppSecret发生泄
+
下图微为唤起分享的流程:
*露,您也可以通过该页面中的重置按钮对其重置,如下图所示:
+
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72208.png}}
 +
发布微博后的来源文案:第三方应用
  
 +
 +
b) 集成分享(需要合作接入,平台BD联系方式参见文档末尾):
 +
集成分享是从官方微博客户端中唤起第三方应用,实现分享过程。
 +
 +
 +
要实现集成分享首先要用户添加第三方应用到附件栏
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72209.png}}
 +
从微博发布页呼起第三方应用,选择内容分享到微博
 +
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72210.png}}
 +
发布微博后的来源文案:官方微博客户端
 +
 +
 +
注意:接入集成分享的第三方,需要在分享后回到官方客户端。
 +
 +
 +
3、LinkCard解析
 +
 +
什么是LinkCard:在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊短链,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72211.png}}
 +
 +
=SDK版本支持=
 +
 +
SDK v2.1已经发布了支持iPhone和Android的版本,需搭配官方客户端3.5.0及以上版本使用。
 +
 +
iPad和Windows Phone请下载SDK v2.0。
 +
 +
SDK下载地址:http://open.weibo.com/wiki/SDK
 +
 +
 +
=SDK接入流程=
 +
 +
===新应用===
 +
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72205.png}}
 +
 +
1、注册成为开发者,创建移动应用
 +
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72203.png}}
 +
 +
如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 : http://open.weibo.com/wiki/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97
 +
 +
创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72201.png}}
 +
 +
2、创建应用完成后,可以在“我的应用 - 应用信息”中查看您所创建应用的APPKEY及APPSECRET,请妥善保管您的这些信息,这将
 +
成为您调用新浪微博开放平台各API的身份标志,如下图所示:
 +
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
 +
 +
 +
3、请在“我的应用 - 应用信息 - 高级信息”中填写您的应用回调页,这样才能使OAuth2.0授权正常进行。如果您的APPSECRET发生泄露,您也可以通过该页面中的重置按钮对其重置,如下图所示:
  
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
  
 +
注:通常Mobile Native App没有服务器回调地址,您可以在应用控制台授权回调页处填写平台提供的默认回调页,该页面用户不可见,仅用于获取access token。
 +
OAuth2.0客户端默认回调页:https://api.weibo.com/oauth2/default.html
  
;6、当您开发完您的应用后,您就可以通过“我的应用”页面提交审核了。只有当您的应用通过审核后,才能在微博中正确显示您的来
 
*源地址等。
 
  
 +
4、在“我的应用 - 应用信息”填写应用的平台信息
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72204.png}}
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
+
这里iPhone应用填写Apple ID和Buddle ID,Android应用填写包名,签名及下载地址。
  
 +
关于各字段含义在控制台中均有说明。
  
;7、您可以通过“我的应用 – 数据统计”页面查看您的应用的相关统计数据,包括应用统计、接口统计、用户特征统计等信息。
 
  
 +
5、下载并集成对应平台SDK到你的应用中,当您开发完您的应用后,您就可以通过“我的应用”页面提交审核了。只有当您的应用通过审核后,才能在微博中正确显示您的来
 +
*源地址等。
 +
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
 +
 +
 +
6、您可以通过“我的应用 – 数据统计”页面查看您的应用的相关统计数据,包括应用统计、接口统计、用户特征统计等信息。
  
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd6.jpg}}
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd6.jpg}}
  
==API接入==
+
===已上线应用===
当您成功申请到AppKey和AppSecret后,您就可以调用微博开放平台上的一系列接口了,详细接口文档请参考:[[API文档 V2|API文档]]
+
 
 +
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72206.png}}
  
==微博小助手==
+
请直接编辑“我的应用 – 应用信息”补充应用平台信息,改字段修改后立即生效,无需二次审核。
;1、什么是微博小助手
+
新浪微博小助手可以将应用与用户微博进行有效联接。方便用户通过微博小助手功能在应用中直接发布、接收新浪微博内容。
+
  
 +
==移动应用商务合作==
 +
移动SDK中的LinkCard和附件栏集成分享权限需要合作申请,商务对接请发邮件至:[mailto:yuqing1@staff.sina.com.cn yuqing1@staff.sina.com.cn]
  
;2、微博小助手功能介绍
+
==SDK常见使用问题==
*小助手功能分为上行和下行两部分:
+
1、应用无法唤起新浪微博客户端
*A、上行——用户通过微博小助手发布接口可实现一键发微博,发图片,发照片,发地理位置信息等,通过一个输入框,让用户
+
应用无法唤起新浪微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。
**一键发送,方便快捷。
+
*B、下行——用户通过小助手,可以及时接收微博信息,例如:微博日报,微博热话题,周边微博信息,微博热榜等,丰富应用
+
**内容,增加用户粘性并提升活跃度。
+
  
 +
2、唤起微博客户端分享,分享完后无法回到第三方应用
 +
第三方应用需要自行处理分享完成后的唤起地址,具体方式可参考SDK中附带的DEMO。
  
;3、合作流程
+
__NOTOC__
*A、双方建立联系,商务对接请发邮件至:[mailto:yuqing1@staff.sina.com.cn yuqing1@staff.sina.com.cn]或[mailto:mobileapps@sina.cn mobileapps@sina.cn]
+
*B、根据应用特色进行产品结合规划。
+
*C、获取接口文档进行技术改造。
+
*D、改造完成,产品上线。
+

2013年7月22日 (一) 15:18的版本

新浪微博已经融入到用户日常生活当中,且具有用户群体庞大、用户粘性高的显著特点。随着网络环境和移动终端功能的不断完善,微博用户随时随地获取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。为方便移动应用接入新浪微博,微博平台提供了相关接口及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。


官方移动应用SDK,竭在方便移动应用开发者更快捷地接入新浪微博开放平台,使用微博API及平台服务。V2.1版SDK在之前SSO授权,接口封装的基础上,增强了对官方微博客户端的开放,使第三方应用具备调用发博,集成至附件栏等功能模块。


SDK功能特性

1、SSO授权

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


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


SSO授权升级至2.0后,更加关注开发者自身的应用安全,客户端无需在本地存储新浪应用的APPSECRET,验证应用需要用到包名和签名(签名仅针对Android)。


SSO授权流程示例图:

sdk72207.png


2、微博原生分享

原生分享(Native Share),既通过调用官方微博客户端的发博器,来实现发送微博的功能。


当前支持两种形式:唤起分享和集成分享。


a) 唤起分享:从第三方应用选择内容分享到微博


下图微为唤起分享的流程:

sdk72208.png

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


b) 集成分享(需要合作接入,平台BD联系方式参见文档末尾): 集成分享是从官方微博客户端中唤起第三方应用,实现分享过程。


要实现集成分享首先要用户添加第三方应用到附件栏

sdk72209.png

从微博发布页呼起第三方应用,选择内容分享到微博

sdk72210.png

发布微博后的来源文案:官方微博客户端


注意:接入集成分享的第三方,需要在分享后回到官方客户端。


3、LinkCard解析

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

sdk72211.png

SDK版本支持

SDK v2.1已经发布了支持iPhone和Android的版本,需搭配官方客户端3.5.0及以上版本使用。

iPad和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和附件栏集成分享权限需要合作申请,商务对接请发邮件至:yuqing1@staff.sina.com.cn

SDK常见使用问题

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

2、唤起微博客户端分享,分享完后无法回到第三方应用 第三方应用需要自行处理分享完成后的唤起地址,具体方式可参考SDK中附带的DEMO。