前几天新浪微博开始邀请合作伙伴,对外接口开始开放.于是我申请到了一个账号.
网站结构
新浪开放平台的域名为open.t.sina.com.cn,目前采用了密码保护,需要先联系相关人员获得密码.
开放平台网站分为两部分,一部分是文档,采用wiki程序组织;一部分是应用的设置和查看界面.
应用的查看部分显示了APP Key和应用用户数.
应用设置页面,是个人信息和应用基本信息设置.
平台接口
接口特点
微博平台采用REST风格的接口,查询类接口要求用GET,发布类接口要求用POST.返回的数据格式有xml和json两种.
REST接口本身有频率限制:
默认REST API的访问限制是每小时150次，限制分用户和IP, 未授权的访问次数限制主要针对IP，登录后的请求访问限制主要针对用户。访问限制主要针对HTTP GET请求。发表操作(如发微博)通常是POST操作而不受此限制。 详细限制情况：请求限制:普通调用限制每小时150次发表微博：单用户每小时最大30次发表评论：单用户每小时最大60次发表私信：单用户每小时最大60次添加关注：每小时最多添加关注60个默认REST API的访问限制是每小时150次，限制分用户和IP, 未授权的访问次数限制主要针对IP，登录后的请求访问限制主要针对用户。访问限制主要针对HTTP GET请求。发表操作(如发微博)通常是POST操作而不受此限制。 详细限制情况：请求限制:普通调用限制每小时150次发表微博：单用户每小时最大30次发表评论：单用户每小时最大60次发表私信：单用户每小时最大60次添加关注：每小时最多添加关注60个
授权等级
微博平台对应用的授权分为多个级别,不同的级别查询的频率有所不同.
普通授权：150次/小时/用户初级授权：500次/小时/用户高级授权：1500次/小时/用户新浪合作伙伴：无限制
认证方式
微博平台支持两种认证方式.
一种是Apache的Basic认证,在你请求接口时把用户名和密码带过来;
一种是Oauth认证.Oauth认证不需要用户提供密码,更加安全.
一个简单的调用例子(取得用户所关注的人的最新微博):
curl -u name:password -d "source=APPKEY" http://api.t.sina.com.cn/statuses/friends_timeline.json
SDK
微博在网站上提供了AS3的SDK.
另外提供了一个修改版本的dabr作为php的示范程序.
Oauth的通用库也添加了一些链接.
另外,我自己写按平台的接口封装了一个简单的PHP Class,目前只支持status相关(详见后边的接口列表)的接口.有兴趣的同学也可以拿去用.
接口分类和列表
获取下行数据集接口
- 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/show 获取单条
- statuses/update 发表微博
- statuses/upload 发表微博及图片
- statuses/destroy 删除
- statuses/repost 转发
- statuses/comment 评论
- statuses/comment_destroy 删除评论
- statuses/reply 回复评论
用户接口
- users/show 个人资料
- 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 关注列表
- followers/ids 粉丝列表
账号接口
- account/verify_credentials 验证身份是否合法
- account/rate_limit_status 查看当前频率限制
- account/end_session 退出
- account/update_profile_image 更改头像
- account/update_profile 更改资料
收藏接口
- favorites 收藏列表
- favorites/create 添加收藏
- favorites/destroy 删除收藏
登录/OAuth接口
另外搜索接口貌似已经在准备中了.
整体上讲微博开放的接口还算细,用户资料和好友关系也开放了.接下来就是如何进行应用和平台的mash up了.