简介
新浪微博开放平台的体系参考了 Twitter ，两者非常类似，包括接口、参数的定义，请求方式等等，如果熟悉 Twitter 的 API ，基本可以同样的适用到新浪微博开放平台上，同时此文档技术部分的信息也可以同样适用于 Twitter 。
新浪微博开放平台的网站为 http://open.t.sina.com.cn/ ，目前只部分页面对匿名用户开放。新浪微博开放平台的官方微博为 http://t.sina.com.cn/openapi ，可以在此申请 API 试用权限。
注册
在开放平台登录后可以看到的界面如下所示：
可以选择创建一个应用，需要设置应用名称、应用地址等。
创建后可以在“我的应用”菜单里看到该应用和使用用户数，系统会为此应用分配一个 APP KEY 和 APP SECRET ，这两个字串非常重要，将会在以后认证或者信息交互时用到。
某应用的详细信息页面
应用分为多个授权级别，分别为普通授权、中级授权、高级授权、合作伙伴授权，可以在 http://open.t.sina.com.cn/wiki/index.php/Rate-limiting 这里看到详细的权限信息。使用合作伙伴授权是没有请求限制的，而普通授权可能一不小心就会 Server Limit 了。
认证
开放平台有两种认证方式，一种是 Basic Auth ，一种是 OAuth 。
1 、 Basic Auth （ HTTP Auth ）
Basic Auth 简单点说明就是每次请求 API 时都提供用户的 username 和 password 。例如：
“ curl -u user:password -d "source=10001&status=api test" http://api.t.sina.com.cn/update.xml ”
。这种方式优点和缺点都很明显。
优点：
u 使用非常简单，
u 开发和调试工作简单，
u 没有复杂的页面跳转逻辑和交互过程；
u 更利于发起方控制；
缺点：
u 安全性低，每次都需要传递用户名和密码，用户名和密码很大程度上存在被监听盗取的可能；
u 同时应用本地还需要保存用户名和密码，在应用本身的安全性来说，也存在很大问题；
u 开放平台服务商出于自身安全性的考虑（第三方可以得到该服务商用户的账号密码，对于服务商来说是一种安全隐患），未来也会限制此认证方式（ Twitter 就计划在 6 月份停止 Basic Auth 的支持）
u 用户如果更改了用户名和密码，还需要重新进行密码校验的过程。
2 、 OAuth
OAuth 为用户资源的授权提供了一个安全、开放的标准，将会是以后开发平台普遍遵守的，目前 Twitter 、 Sina 微博、豆瓣、 Google 等都提供对它的支持。它分为几个交互过程：
1 ）应用用 APP KEY 和 APP SECRET 换取 OAuth_token ；
2 ）应用将用户引导到服务商的页面对该 OAuth_token 进行授权（可能需要输入用户名和密码）；
3 ）服务商的页面跳转回应用，应用再根据参数去服务商获得 Access Token ；
4 ）使用这个 Access Token 就可以访问 API 了。
上述过程如下图所示：
OAuth 认证过程
OAuth 的优点：
u 安全性高，用户的账户和密码只需要提供一次，而且是在服务商的页面上提供，防止了 Basic Auth 反复传输密码带来的安全隐患；
u Access Token 访问权限仅限于应用，被窃取不会影响用户在该服务商的其他服务；
u Access Token 即使被监听丢失了随时可以撤销，不像密码丢失可能就被别人篡改了；
u 用户修改了密码也不会影响该应用的正常使用。
具体 OAuth 的分析详见这篇文章： http://blog.csdn.net/hereweare2009/archive/2009/03/08/3968582.aspx ，标准文档见 http://docs.google.com/View?id=dcmnpkqd_2wxwfwrdg 。
新浪微博开放平台提供了多种类型的认证页面，例如下面的图：
标准的授权页面
弹出窗口类型的授权页面
开发
开放平台的 API 接口基本都是以 RESTFUl 的方式给出，有统一的参数和响应格式。
实际开发的例子， Basic Auth 我将采用 PHP 和 Perl 两种方式， OAuth 我将采用 PHP 和 Javascript 两种方式，另外结合命令行来给予全面的说明。
1 、 Basic Auth 之用户认证
用户认证的接口是 Account/verify credentials ， json 数据访问的方式为“ curl -u uid:password http://api.t.sina.com.cn/account/verify_credentials.json?source=appkey ”。 uid 可以是用户在新浪的 username ，也可以是用户编号。
通过命令行执行的结果如下所示：
命令行请求用户验证接口
下面为 PHP 用 curl 方式请求此接口的代码示例：
$username = $_POST['username'];
$password = $_POST['password'];
// param validate
// …
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "http://api.t.sina.com.cn/account/verify_credentials.json?source=xxxxxxx");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, "$username:$password");
$data = curl_exec($curl);
curl_close($curl);
如果用 Perl 的方式来实现，可以试试 Perl 的 LWP::Curl 和 WWW::Curl 模块，或者简单用执行系统命令方式实现，代码如下：
my $json = `curl -u $username:$password -d count=3 -d since_id=$since_id http://api.t.sina.com.cn/account/verify_credentials.json?source=xxxxxxx`;
如果认证成功，返回的是用户个人信息，如果认证失败，将返回错误信息，例如：
<?xml version="1.0" encoding="UTF-8"?><hash><request>/account/verify_credentials.xml</request><error_code>400</error_code><error>Error: source paramter(appkey) is missing</error></hash>
2 、 Basic Auth 之好友消息获取
好友消息获取是一个最常用的功能，能够取得所关注用户的最新消息列表。 API 主要参数包括 since_id 、 max_id 、 count 、 page 。常用到的是 count 和 since_id 。 count 表示取的消息数量，而 since_id 表示从哪条消息开始取，如果要做增量更新功能，就可以记录每一次最新一条消息的 id ，然后下一次将这一条消息的 id 作为 since_id 去请求接口。
通过命令行请求此接口如下图所示：
命令行请求好友消息接口
从返回的 json 数据里取得一条消息的内容、发表时间、用户昵称、用户头像等信息， Perl 可以采用如下的代码：
my $statuses = JSON::from_json($json);
if(@$statuses[0]) { # must have new messages
for my $status ( @$statuses ) {
my $name = $status->{user}{screen_name};
my $text = $status->{text};
my $create_at = $status->{created_at};
my $id = $status->{id};
my $img = $status->{user}->{profile_image_url};
}
}
3 、 Basic Auth 之用户未读消息获取
用户未读消息获取的接口是 Statuses/unread ， json 数据访问方式为“ curl -u uid:password http://api.t.sina.com.cn/statuses/unread.json?source=appkey ”。接口将返回用户未读消息数，包括 @ 我的，新评论，新私信，新粉丝数。
返回的结果如下所示：
{"followers":5,"dm":0,"mentions":1,"comments":2}
4 、 OAuth 方式
用 PHP 开发 OAuth 方式的新浪微博应用其实比较简单，因为开放平台提供了 SDK 供开发人员使用，地址见 http://code.google.com/p/libweibo/ ，但是在示例里 index.php 里用 $_SERVER[‘SCRIPT_URI’] 有可能出现问题，需要用 HTTP_HOST 和 REQUEST_URI 构造完整路径。
这里我主要想介绍的是用本地应用方式，基于 HTML 和 Javascript 的方式实现新浪微博的应用，以实现一个傲游浏览器的插件为例。
首先要解决几个问题。
第一， Ajax 跨域问题：我们从本地通过 Javascript 请求新浪微博 API 时，都是跨域的。解决方式很多， 1 、使用 PHP 做一个本域的访问代理，当然用这种方式就算不上纯本地应用了； 2 、使用 Ajax 跨域方法，例如动态的 Script 标签； 3 、如果是傲游的插件，这算不上是一个问题，因为浏览器的插件可以跨域访问远程地址。
第二，加密算法问题： OAuth 的请求需要进行签名，需要算法的支持。新浪微博开放平台的文档建议采用 HMAC-SHA1 方式。 js 有一个 sha1 的类库，里面实现了常用的 SHA1 加密算法。使用里面的 b64_hmac_sha1 方法就可以得到符合格式的签名。
第三，页面跳转问题：在 OAuth 流程里，有一步是从新浪用户授权页面跳转到应用的 callback 页面，这一个过程在本地应用来说，是有问题的。以傲游浏览器为例，打开页面都是以本地文件的方式（ file:/// ），此页面不存在一个网络上的地址，所以，将 file:/// 开头的地址作为 callback 地址给新浪用户授权页面时，通过后台跳转的它无法解析此页面的地址，也无法跳转到相应的本地页面（就是说此页面必须有在一个确定的域名下）。这个问题是很难解决的，而从浏览器端进行改动代价太大，幸好新浪微博授权 API 为不方便访问 Web 页面的应用提供了 oauth_callback 的 json 方式，正好帮助我们解决这个问题。
应用的结构如下图所示：
本地应用的系统结构
配置页面用于账户授权或者取消授权。点击账户授权跳转到登录页面。登录页面首先要从 request_token API 获得未经授权的 token ，然后在用户输入用户名和密码后将参数都提交到 authorize API 获得 verifier ，然后跳转到回调页面，回调页面根据 verifier 和 token 去 access_token API 获得经过授权的 token ，认证过程完成。 token 保存在本地（ cookies 、本地文件、浏览器账户配置等方式），以后每次获取消息或者发表消息都需要使用此 token 。消息显示页面可以通过 Ajax 增量更新或者定时刷新页面的方式来更新用户信息。下面是获取 request_token 的核心代码。
function get_request_token() {
var param_arr = ["oauth_consumer_key=" + oauth_consumer_key,
"oauth_nonce=" + oauth_nonce,
"oauth_signature_method=" + oauth_signature_method,
"oauth_timestamp=" + oauth_timestamp,
"oauth_version=" + oauth_version];
base_string = oauth_method + "&" + encodeURIComponent(request_token_api) + "&" + encodeURIComponent(param_arr.join("&"));
oauth_signature = b64_hmac_sha1(app_secret + "&", base_string) + "=";
args = "oauth_consumer_key=" + encodeURIComponent(oauth_consumer_key)
+ "&oauth_nonce=" + encodeURIComponent(oauth_nonce)
+ "&oauth_timestamp=" + encodeURIComponent(oauth_timestamp)
+ "&oauth_signature_method=" + encodeURIComponent(oauth_signature_method)
+ "&oauth_signature=" + encodeURIComponent(oauth_signature)
+ "&oauth_version=" + encodeURIComponent(oauth_version);
Lite.IO.ajaxGet(request_token_proxy, args, set_oauth_token_callback);
}
傲游浏览器插件的一个简单效果图如下图所示：
新浪微博开放平台应用 - 傲游浏览器插件示意图
推送与抓取
上述的解决方案都是基于应用自身抓取的方式，需要定时进行。而实现新浪微博到应用的推送功能据新浪内部消息，此接口正在开发中。
而实现应用从服务器端到客户端的推送，目前比较好的解决方案有基于 Java 的 Comet ，另外 Nginx 也有一个模块 NGINX_HTTP_Push_Module 可以用作服务器端的推送，配置和使用都比较方便，但是缺点是此模块并不完善，只能实现一次推送，推送完毕后长链接就会关闭。此外一个简单的推送办法是利用 HTTP 协议的 multipart/x-mixed-replace 头，可以实现简单的服务器端推送（目前仅支持 firefox 和 webkit 浏览器）。用 PHP 实现的话可以调用一个现成的类库 - http://www.google.cn/codesearch/p?hl=zh-CN#CAa88S9-H3Q/saf/lib/CGI/Cookie.php&q=serverpush%20php&d=3 ，然后用如下的代码就可以看到服务器端推送的效果了。
<?php
$spush = new ServerPush ('replace');
// display the message "Hello, how are you today?" one word at a time
// with a two second delay between words.
$spush->rotate (array (
'Hello,',
'how',
'are',
'you',
'today?',
), 2);
?>
其他
我很好奇的研究了 Chrome 的插件 Sina Twitter ，惊奇的发现它并没有使用新浪的任何 API ，完全是基于页面抓取实现的，这也是从另外一个实现新浪微博插件的思路。
至于要实现 Twitter 的应用，可以使用一个叫 class.twitter.php 的类库，已经封装了很多功能（但是还有一些不完善的地方，我个人也对它进行了一些改进）。
附：新浪微博开放 API 一览
获取下行数据集 (timeline) 接口
- statuses/public_timeline 获取最新更新的公共微博消息
- statuses/friends_timeline 获取当前用户所关注用户的最新微博信息 ( 别名 : statuses/home_timeline)
- statuses/user_timeline 获取用户发布的微博信息列表
- statuses/mentions 获取 @ 当前用户的微博列表
- statuses/comments_timeline 获取当前用户发送及收到的评论列表
- statuses/comments_by_me 获取当前用户发出的评论
- statuses/comments 获取指定微博的评论列表
- statuses/counts 批量获取一组微博的评论数及转发数
- statuses/unread 获取当前用户未读消息数
微博访问接口
- statuses/show 根据 ID 获取单条微博信息内容
- user/status/id 根据微博 ID 和用户 ID 跳转到单条微博页面
- statuses/update 发布一条微博信息
- statuses/upload 上传图片并发布一条微博信息
- statuses/destroy 删除一条微博信息
- statuses/repost 转发一条微博信息（可加评论）
- statuses/comment 对一条微博信息进行评论
- statuses/comment_destroy 删除当前用户的微博评论信息
- statuses/reply 回复微博评论信息
用户接口
- users/show 根据用户 ID 获取用户资料（授权用户）
- statuses/friends 获取当前用户关注对象列表及最新一条微博信息
- statuses/followers 获取当前用户粉丝列表及最新一条微博信息
私信接口
- direct_messages 获取当前用户最新私信列表
- direct_messages/sent 获取当前用户发送的最新私信列表
- direct_messages/new 发送一条私信
- direct_messages/destroy 删除一条私信
关注接口
- friendships/create 关注某用户
- friendships/destroy 取消关注
- friendships/exists 是否关注某用户 ( 推荐使用 friendships/show)
- friendships/show 获取两个用户关系的详细情况
Social Graph 接口
- friends/ids 获取用户关注对象 uid 列表
- followers/ids 获取用户粉丝对象 uid 列表
账号接口
- account/verify_credentials 验证当前用户身份是否合法
- account/rate_limit_status 获取当前用户 API 访问频率限制
- account/end_session 当前用户退出登录
- account/update_profile_image 更改头像
- account/update_profile 更改资料
- account/register 注册新浪微博帐号
收藏接口
- favorites 获取当前用户的收藏列表
- favorites/create 添加收藏
- favorites/destroy 删除当前用户收藏的微博信息
登录 /OAuth 接口
- oauth OAuth 授权方式介绍
- oauth/request_token 获取未授权的 Request Token
- oauth/authorize 请求用户授权 Token
- oauth/access_token 获取授权过的 Access Token
重要字段说明
- status 微博信息内容
- user 用户资料信息
- comment 评论信息描述
- direct_message 私信信息
- 省份城市编码表
取自 " http://open.t.sina.com.cn/wiki/index.php/Rest_API "
转自：http://www.baohe.com/album/view-14341-77126.html
1364
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
