跳转到: 导航, 搜索
(如何申请Appkey)
 
(未显示7个用户的38个中间版本)
第1行: 第1行:
=为什么接入新浪微博=
+
=移动客户端接入=
新浪微博经过两年的发展已经融入到大量手机用户生活当中,且具有用户群体庞大、用户粘性高的显著特点。随着网络环境和移动终端功能的不断优化,微博用户随时随地读取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。为方便移动应用接入新浪微博功能,手机微博平台提供了相关接口以及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化的升级服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。
+
  
=客户端接入流程=
+
<div class="wiki_txtJ">
==如何申请Appkey==
+
为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。
 +
</div>
  
  
;1、在浏览器中打开新浪微博开放平台:http://open.weibo.com  登录您的微博帐号后进入应用开发版块,点击创建应用,如下图:
 
  
 +
=SDK功能特性=
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd1.jpg}}
+
<div class="wiki_txtJ">
 +
'''用微博账号登录'''
 +
</div>
  
  
;2、在按下创建应用后弹出的页面中,注意选择“客户端”类型,如下图:
+
<div class="wiki_txtJ">
 +
微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。
  
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd.png}}
+
{{Img_polaroid|src=https://weiboblog-wordpress.stor.sinaapp.com/uploads/2015/01/image0051-600x308.png}}
  
  
;3、选择客户端之后,在新打开的页面中输入所需创建应用的基本信息。注意选择正确的应用分类:客户端 - 手机,以便我们提供
+
对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)
*给您更多针对性的服务,如下图所示:
+
  
  
{{left|http://www.sinaimg.cn/blog/developer/wiki/khd311.png}}
+
用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。
  
  
;4、创建应用完成后,可以在“我的应用 – 应用信息”中查看您所创建应用的AppKey及AppSecret,请妥善保管您的这些信息,这将
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72207.png}}
*成为您调用新浪微博开放平台各API的身份标志,如下图所示:
+
  
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
+
授权机制请参考授权技术说明文档:[[授权机制|授权机制]]
 +
</div>
  
  
;5、请在“我的应用 – 应用信息 – 高级信息”中填写您的应用回调页,这样才能使OAuth2.0授权正常进行。如果您的AppSecret发生泄
 
*露,您也可以通过该页面中的重置按钮对其重置,如下图所示:
 
  
 +
<div class="wiki_txtJ">
 +
'''分享到微博'''
 +
</div>
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
 
  
 +
<div class="wiki_txtJ">
 +
SDK提供了原生、H5多种分享方式供开发者自由选择,无论用户手机中是否安装了微博客户端,用户都能顺利分享。
  
;6、当您开发完您的应用后,您就可以通过“我的应用”页面提交审核了。只有当您的应用通过审核后,才能在微博中正确显示您的来
 
*源地址等。
 
  
 +
原生唤起分享的流程,发布后微博来源显示第三方应用名称。
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
 
  
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72208.png}}
  
;7、您可以通过“我的应用 – 数据统计”页面查看您的应用的相关统计数据,包括应用统计、接口统计、用户特征统计等信息。
 
  
 +
分享链接LinkCard解析,在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊链接,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd6.jpg}}
 
  
==API接入==
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72211.png}}
当您成功申请到AppKey和AppSecret后,您就可以调用微博开放平台上的一系列接口了,详细接口文档请参考:[[API文档 V2|API文档]]
+
  
==微博小助手==
 
;1、什么是微博小助手
 
新浪微博小助手可以将应用与用户微博进行有效联接。方便用户通过微博小助手功能在应用中直接发布、接收新浪微博内容。
 
  
 +
分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。
 +
</div>
  
;2、微博小助手功能介绍
 
*小助手功能分为上行和下行两部分:
 
*A、上行——用户通过微博小助手发布接口可实现一键发微博,发图片,发照片,发地理位置信息等,通过一个输入框,让用户
 
**一键发送,方便快捷。
 
*B、下行——用户通过小助手,可以及时接收微博信息,例如:微博日报,微博热话题,周边微博信息,微博热榜等,丰富应用
 
**内容,增加用户粘性并提升活跃度。
 
  
  
;3、合作流程
+
==SDK版本支持==
*A、双方建立联系,商务对接请发邮件至:[mailto:yuqing1@staff.sina.com.cn yuqing1@staff.sina.com.cn][mailto:mobileapps@sina.cn mobileapps@sina.cn]
+
 
*B、根据应用特色进行产品结合规划。
+
 
*C、获取接口文档进行技术改造。
+
===iOS SDK===
*D、改造完成,产品上线。
+
 
 +
<div class="wiki_txtJ">
 +
目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。
 +
</div>
 +
 
 +
 
 +
<div class="wiki_taglist">
 +
<ul class="clearfix">
 +
<li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li>
 +
<li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_ios_sdk iOS SDK下载]</li>
 +
</ul>
 +
</div>
 +
 
 +
 
 +
 
 +
===Android SDK===
 +
 
 +
<div class="wiki_txtJ">
 +
目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。
 +
</div>
 +
 
 +
 
 +
<div class="wiki_taglist">
 +
<ul class="clearfix">
 +
<li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li>
 +
<li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/2019SDK Android SDK下载]</li>
 +
</ul>
 +
</div>
 +
 
 +
 
 +
 
 +
==SDK接入流程==
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
'''1、注册成为开发者,创建移动应用'''
 +
</div>
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 :[[新手指南]]
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72205.png}}
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72203.png}}
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72201.png}}
 +
 
 +
 
 +
创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。
 +
</div>
 +
 
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
'''2、创建应用完成后,进行SDK配置'''
 +
</div>
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志:
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
 +
 
 +
 
 +
在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置:
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
 +
 
 +
 
 +
注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:<nowiki>https://api.weibo.com/oauth2/default.html</nowiki>
 +
 
 +
 
 +
在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72204.png}}
 +
</div>
 +
 
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
'''3、下载并集成对应平台的微博移动SDK到你的应用中'''
 +
</div>
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
 +
</div>
 +
 
 +
 
 +
 
 +
==移动应用商务合作==
 +
 
 +
移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:[mailto:zhangdi2@staff.weibo.com zhangdi2@staff.weibo.com]、[mailto:siqin1@staff.weibo.com siqin1@staff.weibo.com][mailto:lingxia@staff.weibo.com lingxia@staff.weibo.com]
 +
 
 +
 
 +
 
 +
==SDK常见使用问题==
 +
 
 +
1、应用无法唤起微博客户端
 +
 
 +
应用无法唤起微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
{{#a:nobtns|noheading}}
 +
__NOTOC__

2023年2月1日 (三) 14:13的最后版本

移动客户端接入

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


SDK功能特性

用微博账号登录


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



对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)


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



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


分享到微博


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、创建应用完成后,进行SDK配置


在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志:



在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置:



注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:https://api.weibo.com/oauth2/default.html


在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。



3、下载并集成对应平台的微博移动SDK到你的应用中


当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。



移动应用商务合作

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


SDK常见使用问题

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

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





文档更新时间: 2023-02-01