/1 / 10新浪微博通用合作方案——产品和技术简介 2010-4-20为什么要合作？和新浪微博进行合作，千万级的新浪微博用户对您的网站和资讯将更加触手可得。
借助微博特有的转发评论等产品功能，您的高质量内容将获得更多的有效传播，也将会被更多的用户所关注。
通过微博专业的运营团队给合作方指导性的帐号营销策略，更能让您的网站和品牌在微博用户中树立形象。
如何合作？需要准备什么？下文将列出几种通用的合作方式，首先将介绍我们管理来源和开发者应用的APPKEY ，接着将说明如何通过Oauth 实现用微博帐号登录您的网站，然后将说明如何在您的网页加入分享按钮，并且我们会回推给您分享的微博方便您后续的跟踪和进行数据分析，最后将要介绍怎么来实现微博消息和您网站的同步，即用户更新了您的网站的状态，微博上也有展现。
如果您还有更多的需求，访问我们的 通过我们开放的，标准的REST API 来满足您一切需求。
关键词：Appkey ，微博来源，Oauth ，分享到微博，评论回推，消息同步/ 2 / 10目录新浪微博通用合作方案 (1)目录 (2)1. appkey ——来源显示，API 调用权限 (3)1.1. 什么是appkey ？ (3)1.2. 如何获得appkey ？ (3)2. Oauth ——用微博帐号登录你的网站，与微博帐号绑定 (4)2.1. 什么是“用微博帐号登录”？ (4)2.2. 如何在您的网站加入“用微博帐号登录”或“绑定微博”？ (4)3. 分享到新浪微博，微博评论回推 (6)3.1. 分享到微博用户，产品流程 (6)3.1.1. 用户点击分享按钮并分享 (6)3.1.2. 微博显示来源网址，或者图片，视频 (7)3.2. 分享到微博技术方法，接口 (7)3.2.1. 加入a 标签 (7)3.2.2. 如果您觉得a 标签麻烦，可以使用以下方法 (8)3.2.3. 视频合作网站url 识别接口 (8)3.3. 什么是微博评论回推？ (9)4. 即时状态双发，微博同步展现 (10)4.1. 合作网站同步到微博 (10)4.2. 微博同步到合作网站 (10)/3 / 101. appkey ——来源显示，API 调用权限1.1. 什么是appkey ？为了保障信息的和谐，和更方便的管理。
每一次的API 请求都必须带上appkey ，对应着开发者的信息。
而appkey 更重要的功能，就是来控制每一条微博的来源文字和链接，例如一个用户用了Iphone 客户端来发布，iphone客户端的开发者将他自己这个应用appkey （包含应用名称和链接）已经写入他的程序中了，这样，任何使用他的程序的用户进行发微博操作的时候，都会显示来自于iphone 客户端。
更多的用户会因为身边的人都使用iphone 客户端然后自己也会去下载一个，达到了传播效果。
1.2. 如何获得appkey ？1，首先您有一个新浪微博帐号。
没有的可以去/reg.php 注册一个。
2，进入 / 在右上角进行登录，并设置自己的开发者信息（重要，信息的完善程度将影响您的应用审核进度，和进入微博广场的进度）。
3，登录后，在我的应用中创建一个应用，其中应用名称和应用地址，就是对应着将来的微博来源文字和来源链接，必须慎重填写。
除此之外，如果您只是网站之间的合作，将开发者信息完善好即刻，其他信息不需要填。
4，申请好以后你将会看到在自己的应用信息下面会有一个appkey 的参数，和app secret 参数，后者请保密，这两个参数将用在以后的编码中。
注：如果需要加速审核的程序可以直接和微博开放平台对外接口的方涛（fangtao1@ ）联系。
接下来，将要介绍3个合作的基本点。
/4 / 102. Oauth ——用微博帐号登录你的网站，与微博帐号绑定 2.1. 什么是“用微博帐号登录”？例如在点评网的登录页中（/login 未登录下查看），有一个入口可以直接使用微博帐号登录，如下图。
已经有微博帐号的用户，可以不用注册点评网即可通过这个入口登录。
登录后，点评网可以直接从微博获取这个用户的一些信息，例如昵称。
同样，已经是点评网的用户，在自己的设置中（ /mysetup/sina 登录后查看），可以绑定新浪微博帐号。
以上两种用户，在点评网的行为，均可以同步到微博，例如发表了点评等。
2.2. 如何在您的网站加入“用微博帐号登录”或“绑定微博”？此部分内容具体需要参考我们的API 文档中的方法：/wiki/index.php/首页#.E7.99.BB.E5.BD.95.2FOAuth.E6.8E.A5.E5.8F.A3不能保证下文内容是最新的，下文只是做一个简单介绍。
2.2.3. 为什么使用Oauth ：为了保护新浪微博用户的数据，当第三方应用需要通过API 访问时，需要通过OAuth 认证机制来获得用户的授权。
虽然目前API 也支持用户名/密码的方式，但是强烈建议第三方开发者和用户都选择OAuth 认证方式。
OAuth 方式无需用户在第三方软件输入用户名/密码，用户验证时是跳到新浪网站进行身份验证。
2.2.4. 可参考资源： [OAUTH 协议简介] /hereweare2009/archive/2009/03/08/3968582.aspx [Beginner ’s Guide to OAuth] /oauth/[OAuth 官网] //5 / 10[Google-OAuth 项目提供各种语言的OAuth 库] /p/oauth/2.2.5. Oauth 的认证流程及访问资源流程：● 获取未授权的 Request Token● 用户授权该Request Token● 通过authorize 得到用户授权后的 Access Token● 使用Access Token 访问或修改受保护资源2.2.6. 常见问题：● 在第一步获取Request Token 时，需要使用Consumer Key 和API Key Secret 进行签名的Consumer Key Secret 。
● 在第二步换取Access Token 时，需要使用Consumer Key ，API Key Secret 、RequestToken 和Request Token Secret 进行签名。
而Request Token 和Request Token Secret对应签名中的Token 和Token Secret● 而在第三步访问受限资源时，需要使用Consumer Key ，API Key Secret 、Access Token和Access Token Secret 进行签名。
● 请注意区分三次签名中用到的Key 、Token 和Secret ，这是签名不匹配的一个常见原因。
● 对于上传图片的接口，需要使用MultPart,认证时图片不加入baseString 做签名。
● 对中文字串做URLEncode 时，注意确定生成的串中的字母必须为大写。
具体上文中的方法可以到我们的API 文档中查询更多详细内容：/wiki/index.php/首页#.E7.99.BB.E5.BD.95.2FOAuth.E6.8E.A5.E5.8F.A3/6 / 103. 分享到新浪微博，微博评论回推关于分享到新浪微博，流程如下：3.1. 分享到微博用户，产品流程3.1.1.用户点击分享按钮并分享点击后，会弹出类似下面的小窗，内容由合作方来定制。
如果用户未登录微博还需要登录微博才能进行分享操作。
/7 / 103.1.2. 微博显示来源网址，或者图片，视频通过分享过来的内容，展示出图片，视频。
并且这条微博有来源，来源是通过appkey 来定制的。
3.2. 分享到微博技术方法，接口在自己的网页上加入“分享到新浪微博”链接。
分享按钮的具体样式不限，可以参考第一张图verycd 的效果。
其中，微博的favicon 地址是：/miniblog/images/common/smalllogo.gif加分享链接可以有以下两种方式：3.2.1. 加入a 标签<ahref="javascript:void((function(s,d,e,r,l,p,t,z,c){var%20f='/share/sha re.php?appkey=1',u=z||d.location,p=['&url=',e(u),'&title=',e(t||d.title),'&source=',e(r),'&s ourceUrl=',e(l),'&content=',c||'gb2312','&pic=',e(p||'')].join('');function%20a(){if(!window .open([f,p].join(''),'mb',['toolbar=0,status=0,resizable=1,width=440,height=430,left=',(s.wi dth-440)/2,',top=',(s.height-430)/2].join('')))u.href=[f,p].join('');};if(/Firefox/.test(nav erAgent))setTimeout(a,0);else%20a();})(screen,document,encodeURIComponent,'','','2','3','4','5'));">分享至微博</a>其中总共有5个可配置参数：1， 就是你申请的appkey ，必须是真实可用的，也就是你注册的appkey2， 传图片功能需要将您的图片服务器加入我们的白名单方可实现，可以联系方涛 3， 微博内容，如果没有就是当前页的title4， 微博内容后面附属的url ，如果没有就是当前页的url5， 页面编码gb2312或者utf-8，为空时默认gb23123.2.2.如果您觉得a标签麻烦，可以使用以下方法/share/share.php?appkey=1&url=2&title=3&content=4&pic=5具体说明是：1，就是你申请的appkey，必须是真实可用的，也就是你注册的appkey2，微博内容后面附属的url3，微博内容4，页面编码gb2312或者utf-85，传图片功能需要将您的图片服务器加入我们的白名单方可实现，可以联系方涛3.2.3.视频合作网站url识别接口如果您是一个视频网站，需要在微博上直接能播放您的视频，需要合作方提供一个接口，我们传入某一个视频url的地址（也就是分享时你们提供的url），合作方接口返回给我们视频缩略图和视频flash播放地址，可以参考：/api/share_sina.php?url=/ptv/vplay/1234.html具体合作方接口返回的格式是（XML数据）：<?xml version="1.0" encoding="UTF-8"?><root><result><coverurl>/mms/thumb/2008/10/22/32859f5e9de8b1aa6ccc9df75a3fe230_2 .jpg</coverurl><flash>/player/swfPlayer.swf?id=1234</flash><title><![CDATA[【冠军杯】曼联 3：0 凯尔特人全场精华]]></title></result></root>说明，注意：●coverurl: 视频缩略图，120*90●flash: 视频Flash播放器地址●title: 分享时候附带的微博内容●注意将返回的页面的content-type设置成text/xml而不是text/html3.3.什么是微博评论回推？评论回推，是微博对合作网站的一种内容贡献方法，目前还不是最优解，只是小范围的试用了一部分合作伙伴。