新浪微博API学习笔记(第一部分)1

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

 

下一篇