新浪微博通用合作方案_20100420

新浪微博通用合作方案——产品和技术简介2010-4-20为什么要合作？和新浪微博进行合作，千万级的新浪微博用户对您的网站和资讯将更加触手可得。借助微博特有的转发评论等产品功能，您的高质量内容将获得更多的有效传播，也将会被更多的用户所关注。通过微博专业的运营团队给合作方指导性的帐号营销策略，更能让您的网站和品牌在微博用户中树立形象。如何合作？需要准备什么？下文将列出几种通用的合作方式，首先将介绍我们管理来源和开发者应用的APPKEY，接着将说明如何通过Oauth实现用微博帐号登录您的网站，然后将说明如何在您的网页加入分享按钮，并且我们会回推给您分享的微博方便您后续的跟踪和进行数据分析，最后将要介绍怎么来实现微博消息和您网站的同步，即用户更新了您的网站的状态，微博上也有展现。如果您还有更多的需求，访问我们的通过我们开放的，标准的RESTAPI来满足您一切需求。关键词：Appkey，微博来源，Oauth，分享到微博，评论回推，消息同步目录新浪微博通用合作方案...................................................................................................................1目录..................................................................................................................................................21.appkey——来源显示，API调用权限.....................................................................................31.1.什么是appkey？..........................................................................................................31.2.如何获得appkey？......................................................................................................32.Oauth——用微博帐号登录你的网站，与微博帐号绑定.....................................................42.1.什么是“用微博帐号登录”？...................................................................................42.2.如何在您的网站加入“用微博帐号登录”或“绑定微博”？...............................43.分享到新浪微博，微博评论回推...........................................................................................63.1.分享到微博用户，产品流程.......................................................................................63.1.1.用户点击分享按钮并分享...............................................................................63.1.2.微博显示来源网址，或者图片，视频...........................................................73.2.分享到微博技术方法，接口.......................................................................................73.2.1.加入a标签.......................................................................................................73.2.2.如果您觉得a标签麻烦，可以使用以下方法...............................................83.2.3.视频合作网站url识别接口............................................................................83.3.什么是微博评论回推？...............................................................................................94.即时状态双发，微博同步展现.............................................................................................104.1.合作网站同步到微博.................................................................................................104.2.微博同步到合作网站.................................................................................................10——来源显示，API调用权限1.1.什么是appkey？为了保障信息的和谐，和更方便的管理。每一次的API请求都必须带上appkey，对应着开发者的信息。而appkey更重要的功能，就是来控制每一条微博的来源文字和链接，例如一个用户用了Iphone客户端来发布，iphone客户端的开发者将他自己这个应用appkey（包含应用名称和链接）已经写入他的程序中了，这样，任何使用他的程序的用户进行发微博操作的时候，都会显示来自于iphone客户端。更多的用户会因为身边的人都使用iphone客户端然后自己也会去下载一个，达到了传播效果。1.2.如何获得appkey？1，首先您有一个新浪微博帐号。没有的可以去注册一个。2，进入在右上角进行登录，并设置自己的开发者信息（重要，信息的完善程度将影响您的应用审核进度，和进入微博广场的进度）。3，登录后，在我的应用中创建一个应用，其中应用名称和应用地址，就是对应着将来的微博来源文字和来源链接，必须慎重填写。除此之外，如果您只是网站之间的合作，将开发者信息完善好即刻，其他信息不需要填。4，申请好以后你将会看到在自己的应用信息下面会有一个appkey的参数，和appsecret参数，后者请保密，这两个参数将用在以后的编码中。注：如果需要加速审核的程序可以直接和微博开放平台对外接口的方涛（[e-mail]）联系。接下来，将要介绍3个合作的基本点。——用微博帐号登录你的网站，与微博帐号绑定2.1.什么是“用微博帐号登录”？例如在点评网的登录页中（未登录下查看），有一个入口可以直接使用微博帐号登录，如下图。已经有微博帐号的用户，可以不用注册点评网即可通过这个入口登录。登录后，点评网可以直接从微博获取这个用户的一些信息，例如昵称。同样，已经是点评网的用户，在自己的设置中（登录后查看），可以绑定新浪微博帐号。以上两种用户，在点评网的行为，均可以同步到微博，例如发表了点评等。2.2.如何在您的网站加入“用微博帐号登录”或“绑定微博”？此部分内容具体需要参考我们的API文档中的方法：首页#.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协议简介][Beginner’sGuidetoOAuth][OAuth官网]://t.sina.com.cn/5/10[Google-OAuth项目提供各种语言的OAuth库]的认证流程及访问资源流程：获取未授权的RequestToken用户授权该RequestToken通过authorize得到用户授权后的AccessToken使用AccessToken访问或修改受保护资源2.2.6.常见问题：在第一步获取RequestToken时，需要使用ConsumerKey和APIKeySecret进行签名的ConsumerKeySecret。在第二步换取AccessToken时，需要使用ConsumerKey，APIKeySecret、RequestToken和RequestTokenSecret进行签名。而RequestToken和RequestTokenSecret对应签名中的Token和TokenSecret而在第三步访问受限资源时，需要使用ConsumerKey，APIKeySecret、AccessToken和AccessTokenSecret进行签名。请注意区分三次签名中用到的Key、Token和Secret，这是签名不匹配的一个常见原因。对于上传图片的接口，需要使用MultPart,认证时图片不加入baseString做签名。对中文字串做URLEncode时，注意确定生成的串中的字母必须为大写。具体上文中的方法可以到我们的API文档中查询更多详细内容：首页#.E7.99.BB.E5.BD.95.2FOAuth.E6.8E.A5.E5.8F.A3分享到新浪微博，微博评论回推关于分享到新浪微博，流程如下：3.1.分享到微博用户，产品流程3.1.1.用户点击分享按钮并分享点击后，会弹出类似下面的小窗，内容由合作方来定制。如果用户未登录微博还需要登录微博才能进行分享操作。