Sina微博应用开发指南

概述

API平台应用日益丰富，为了让开发者更容易了解开发流程；为了规范API的接口，需要制定开发规范；为了对开发者进行一些深层次的指导，让开发者怎样来最优的访问API接口，特此制定开发流程技术规范与指南。

开发流程

申请APPKEY

1. 进入http://open.t.sina.com.cn
2. 如果您有新浪微博账户，可以直接登录，没有则注册一个微博账户后登录
3. 登录后进入我的应用，创建一个应用
4. 创建完成后会生成对应的appkey,app_secret,记住：您的app_key别对外泄露。

应用创建及发布流程

应用的创建及发布包括下面的流程，开发者可以根据应用当前的状态进行相应的操作

开发指南

SDK简介及作用

SDK是特定语言实现的一个可以通用的API使用的工具，SDK实现了新浪开放平台的全部或大部分接口，以便开发者不用关心API接口细节，认证实现等，可以直接调用接口完成特定的功能。支持新浪微博开放平台接口的SDK语言包括Adobe air,c++,c#,java,php,python,ios等，具体请参考SDK列表页面

如何通过授权访问数据

微博开放平台对外支持两种用户认证方式，Basic auth 以及OAUTH认证微博开放平台对外支持两种用户认证方式，Basic auth 以及OAUTH认证

Basic auth

通过设置http的消息头带上用户名密码

具体设置如下

设置消息头的Authonrization的值为：

Basic base64("uid:password")

Curl使用Basic auth获取数据样例

curl -v -u uid:pwd " http://api.t.sina.com.cn/users/show.xml?source=appkey"

OAUTH认证

OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准。

关于OAUTH协议可以参考  http://oauth.net

使用OAUTH认证来获取微博数据介绍详细见： OAuth

如何访问匿名接口

为了方便一些应用在没有用户认证情况下需要获取一些数据，微博开放平台提供了一些匿名访问接口。

匿名访问时必须带上参数source=appkey(您申请时获取到的appkey值)

匿名访问样例

curl " http://api.t.sina.com.cn/statuses/public_timeline.xml?source=appkey"

现开放的匿名接口如下

uri	接口说明	限制
/statuses/public_timeline	获取最新微博	只返回最新的20条微博
/statuses/user_timeline	获取用户微博	支持按screen_name来获取
/statuses/counts	获取微博的转发数评论数
/statuses/followers	获取粉丝列表
/users/show	获取某用户信息	支持按screen_name来获取
/search	搜索微博	最多返回20条
/statuses/search	搜索微博	最多返回20条
/users/search	搜索微博用户	最多返回20条

接口数据如何适当的缓存

在您的应用中，在正常业务需要的情况下，尽量减少请求量，减少请求接口返回数据，有必要缓存一些已经获取到的数据，来提高应用的效率和体验。下面一些场景，可供参考:

获取/statuses/friends_timeline(用户首页)

1. 第一次请求后，缓存下请求内容
2. 下一次刷新的时候使用since_id(值为前一次请求的最大微博id)来获取更新

获取/statuses/followers(用户粉丝)

1. 第一次请求后，缓存下请求内容
2. 当获取/statuses/unread接口有新粉丝的时候，则重新获取，没有则不变更
3. 完成后调用/statuses/reset_count来清除消息提醒

获取/direct_messages(用户私信)

1. 第一次请求后，缓存下请求内容
2. 当获取/statuses/unread接口有新私信的时候，则重新获取，没有则不变更
3. 完成后调用/statuses/reset_count来清除消息提醒

获取/statuses/mentions(用户提到)

1. 第一次请求后，缓存下请求内容
2. 当获取/statuses/unread接口有新粉丝的时候，则重新获取，没有则不变更
3. 完成后调用/statuses/reset_count来清除消息提醒

对很少变动的数据缓存

1. 用户昵称,头像很少更改，可对用户昵称,头像做一个较长的缓存
2. 表情数据 很少更改，可以缓存一个很长的缓存

如何避免rate limit

微博开放平台会对每个应用的用户有一个频率限制，怎样来让用户的操作不达到频率限制呢？下面有一个简单的样例，参考下:

1. 确定哪些需要定时访问的接口，每个接口做一个优先级，访问的频率做为一个变量
2. 计算下一定要访问的接口数据量
3. 预留给用户一定的更新(发微博，私信等)
4. 使用Account/rate_limit_status查看当前appkey所能支持的每小时的最大访问量，根据此访问量来确定频率的值