静坐常思己过,闲谈莫论人非,能受苦乃为志士,肯吃亏不是痴人,敬君子方显有德,怕小人不算无能,退一步天高地阔,让三分心平气和,欲进步需思退步,若着手先虑放手,如得意不宜重往,凡做事应有余步。持黄金为珍贵,知安乐方值千金,事临头三思为妙,怒上心忍让最高。切勿贪意外之财,知足者人心常乐。若能以此去处事,一生安乐任逍遥。

新浪微博API学习(一)

作者:大鹏 发布于:2011-4-7 9:27 Thursday 分类:PHP&MySql

1.1 获取下行数据集(timeline)接口
1、statuses/public_timeline 获取最新的公共微博消息
返回最新的20条公共微博。返回结果非完全实时,最长会缓存60秒
url:http://api.t.sina.com.cn/statuses/public_timeline.(json|xml)
支持格式:JSON|XML
HTTP请求方式:GET
是否需要登录:false
请求数限制:true
请求参数:

必选
类型范围
说明
source
true
string
申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
count
false
int缺省值20,最大值200
每次返回的记录数
base_app
false
int
是否仅获取当前应用发布的信息。0为所有,1为仅本应用。
       调用示例
XML:curl -u "username:password"
"http://api.t.sina.com.cn/statuses/public_timeline.xml?source=appkey&count=5"
JSON:curl -u "username:password"
"http://api.t.sina.com.cn/statuses/public_timeline.json?source=appkey&count=5"
返回结果:
      字段说明:-status
              created_at: 创建时间 //微博的发布时间
id: 微博ID //表示发布的微博消息的ID号
text: 微博信息内容
source: 微博来源
favorited: 是否已收藏
truncated: 是否被截断
in_reply_to_status_id: 回复ID
in_reply_to_user_id: 回复人UID
in_reply_to_screen_name: 回复人昵称
thumbnail_pic: 缩略图
bmiddle_pic: 中型图片
original_pic:原始图片
user: 作者信息
retweeted_status: 转发的博文,内容为status,如果不是转发,则没有此字段
字段说明:-status
              id: 用户UID //用户的ID号,如http://t.sina.com.cn/uid表示该用户的微博地址
screen_name: 微博昵称
name: 友好显示名称,同微博昵称
province: 省份编码(参考省份编码表)
city: 城市编码(参考城市编码表)
location:地址
description: 个人描述
url: 用户博客地址
profile_image_url: 自定义图像
domain: 用户个性化URL //可以看做是用户的微博地址的别称,假设是该用户的
UID是123456,domain是sdxhuati则地址http://t.sina.com.cn/123456等价于http://t.sina.com.cn/sdxhuati,都链接到该用户的微博地址
gender: 性别,m--男,f--女,n--未知
followers_count: 粉丝数
friends_count: 关注数
statuses_count: 微博数
favourites_count: 收藏数
created_at: 创建时间 //用户的创建时间
following: 是否已关注(此特性暂不支持)
verified: 加V标示,是否微博认证用户
      
编程示例:(Java)首先要修改weibo4j.Weibo类的源码:将申请到的Appkey和AppSecret设置为该类的两个域CONSUMER_KEY和CONSUMER_SECRET的值即可。

2、statuses/friends_timeline 获取当前登录用户及其所关注用户的最新微博消息 (别名: statuses/home_timeline)
获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://t.sina.com.cn 后在“我的首页”中看到的内容相同。别名statuses/home_timeline
URL:http://api.t.sina.com.cn/statuses/friends_timeline.(json|xml)
支持格式:XML/JSON
HTTP请求方式:GET
是否需要登录:true
请求数限制:true
请求参数:

必选
类型范围
说明
source
true
string
申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
since_id
false
int64
若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。
max_id
false
int64
若指定此参数,则返回ID小于或等于max_id的微博消息
count
false
int,默认值20,最大值200。
指定要返回的记录条数
page
false
int默认值是1
指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数,翻页功能最多能查看的总记录数会有所不同,通常最多能查看1000条左右。
base_app
false
int
是否仅获取当前应用发布的信息。0为所有,1为仅本应用。
feature
false
int
微博类型,0全部,1原创,2图片,3视频,4音乐. 返回指定类型的微博信息内容。
调用示例:
XML: curl -u "username:password" "http://api.t.sina.com.cn/statuses/friends_timeline.xml?source=appkey&count=5&page=10"
JSON:curl -u "username:password"
http://api.t.sina.com.cn/statuses/friends_timeline.json?source=appkey&count=5&page=10


标签: oauth

et_highlighter
发表评论 »本文目前尚无任何评论

发表评论

干净网络从你做起,切勿黏贴小广告