新浪微博通用合作方案.doc

新浪微博通用合作方案 ——产品和技术简介 2010-4-20 为什么要合作？ 和新浪微博进行合作，千万级的新浪微博用户对您的网站和资讯将更加触手可得。借助微博特有的转发评论等产品功能，您的高质量内容将获得更多的有效传播，也将会被更多的用户所关注。通过微博专业的运营团队给合作方指导性的帐号营销策略，更能让您的网站和品牌在微博用户中树立形象。 如何合作？需要准备什么？ 下文将列出几种通用的合作方式，首先将介绍我们管理来源和开发者应用的APPKEY，接着将说明如何通过Oauth实现用微博帐号登录您的网站，然后将说明如何在您的网页加入分享按钮，并且我们会回推给您分享的微博方便您后续的跟踪和进行数据分析，最后将要介绍怎么来实现微博消息和您网站的同步，即用户更新了您的网站的状态，微博上也有展现。 如果您还有更多的需求，访问我们的 通过我们开放的，标准的REST API来满足您一切需求。 关键词： Appkey，微博来源，Oauth，分享到微博，评论回推，消息同步 目录 新浪微博通用合作方案 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 appkey——来源显示，API调用权限 什么是appkey？ 为了保障信息的和谐，和更方便的管理。每一次的API请求都必须带上appkey，对应着开发者的信息。 而appkey更重要的功能，就是来控制每一条微博的来源文字和链接，例如一个用户用了Iphone客户端来发布，iphone客户端的开发者将他自己这个应用appkey（包含应用名称和链接）已经写入他的程序中了，这样，任何使用他的程序的用户进行发微博操作的时候，都会显示来自于iphone客户端。更多的用户会因为身边的人都使用iphone客户端然后自己也会去下载一个，达到了传播效果。 如何获得appkey？ 1，首先您有一个新浪微博帐号。没有的可以去/reg.php 注册一个。 2，进入 / 在右上角进行登录，并设置自己的开发者信息（重要，信息的完善程度将影响您的应用审核进度，和进入微博广场的进度）。 3，登录后，在我的应用中创建一个应用，其中应用名称和应用地址，就是对应着将来的微博来源文字和来源链接，必须慎重填写。除此之外，如果您只是网站之间的合作，将开发者信息完善好即刻，其他信息不需要填。 4，申请好以后你将会看到在自己的应用信息下面会有一个appkey的参数，和app secret参数，后者请保密，这两个参数将用在以后的编码中。 注：如果需要加速审核的程序可以直接和微博开放平台对外接口的方涛（fangtao1@）联系。 接下来，将要介绍3个合作的基本点。 Oauth——用微博帐号登录你的网站，与微博帐号绑定 什么是“用微博帐号登录”？ 例如在点评网的登录页中（ /login 未登录下查看），有一个入口可以直接使用微博帐号登录，如下图。已经有微博帐号的用户，可以不用注册点评网即可通过这个入口登录。登录后，点评网可以直接从微博获取这个用户的一些信息，例如昵称。 同样，已经是点评网的用户，在自己的设置中（ /mysetup/sina 登录后查看），可以绑定新浪微博帐号。 以上两种用户，在点评网的行为，均可以同步到微博，例如发表了点评等。 如何在您的网站加入“用微博帐号登录”或“绑定微博”？ 此部分内容具体需要参考我们的API文档中的方法： /wiki/index.php/首页#.E7.99.BB.E5.BD.95.2FOAuth.E6.8E.A5.E5.8F.A3/hereweare2009/archive/2009/03/08/3968582.aspx [Beginner’s Guide to OAuth] /oauth/ [OAuth官网] / [Google-OAuth项目提供各种语言的OAuth库] /p/oauth/ 2.2.5. Oauth的认证流程及访问资源流程