基本概念

API输入输出字符集约定：UTF-8

用户验证如需要验证用户,验证方式为HTTP Basic 验证。

用户 id用户id在个人网址中，例如：http://t.cnfol.com/cnfolqh蓝色的部分即为用户名称。

使用 API 的简单途径如果你的系统中有 cURL,就可以通过非常简单的方式使用这些API了。

用户 id示例：显示随便看看的消息curl http://api.t.cnfol.com/statuses/public_timeline.xml显示用户消息curl -u loginname:password http://api.t.cnfol.com/statuses/user_timeline.xml显示用户和好友的信息curl -u loginname:password http://api.t.cnfol.com/statuses/friends_timeline.xml发布消息curl -u loginname:password -d status="消息内容" http://api.t.cnfol.com/statuses/update.xml

关于使用XML格式数据说明使用xml格式的数据为了支持更多的数据，在处理时我们将做了base64处理，在xml中会遇到火星文 & < > 等无法解析的字符

访问限制Rate limiting微博API限制客户端每小时只能执行有限个请求。详述如下：REST API Rate Limiting默认REST API的访问限制是每小时150次，限制分用户和IP, 未授权的访问次数限制主要针对IP，登录后的请求访问限制主要针对用户。访问限制主要针对HTTP GET请求。发表操作(如发微博)通常是POST操作而不受此限制。详细限制情况：请求限制:普通调用限制每小时150次发表微博：单用户每小时最大30次发表评论：单用户每小时最大60次发表私信：单用户每小时最大60次添加关注：每小时最多添加关注60个，每天最多关注200个

API 方法说明

消息相关的方法

显示随便看看的消息路径http://api.t.cnfol.com/statuses/public_timeline.[json|xml|rss]参数：count (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/public_timeline.rss?count=10format (可选） － 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/public_timeline.json?callback=getStatuses

显示用户和好友的消息路径：http://api.t.cnfol.com/statuses/friends_timeline.[json|xml|rss]参数：id - 用户 id，没有此参数或用户设隐私时需验证用户。有此参数时返回的是此用户和好友的所有消息，没有此参数时返回的是当前用户的首页中的最新消息。(注明歧义)示例：http://api.t.cnfol.com/statuses/friends_timeline.rss?id=cnfolcount (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/friends_timeline.rss?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/friends_timeline.xml?since_id=6IAZmgy1TzA &id=333 示例：max_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/friends_timeline.xml?max_id=6IAZmgy1TzApage (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/friends_timeline.json?page=3format (可选）－ 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/friends_timeline.json?callback=getStatuses

路径：http://api.t.cnfol.com/statuses/user_timeline.[json|xml|rss]参数：id (可选) - 用户 id，没有此参数或用户设隐私时需验证用户。示例：http://api.t.cnfol.com/statuses/user_timeline.rss?id=cnfol 或http://api.t.cnfol.com/statuses/user_timeline/cnfol.rsscount (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/user_timeline.rss?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/user_timeline.xml?since_id=6IAZmgy1TzA1max_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/user_timeline.xml?max_id=6IAZmgy1TzApage (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/user_timeline.json?page=3format (可选) － 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/user_timeline.json?callback=getStatuses

显示指定消息路径：http://api.t.cnfol.com/statuses/show/id.[json|xml|rss]参数：id (必需) - 消息的id。示例：http://api.t.cnfol.com/statuses/show/6IAZmgy1TzA.xml

显示发给当前用户的消息路径：http://api.t.cnfol.com/statuses/replies.[json|xml|rss]参数：count (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/replies.rss?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/replies.xml?since_id=6IAZmgy1TzAmax_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/replies.xml?max_id=6IAZmgy1TzApage (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/replies.json?page=3format (可选）－ 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。

发布消息路径：http://api.t.cnfol.com/statuses/update.[json|xml]方法：POST参数：status (必需) - 消息内容，使用 POST 方式提交in_reply_to_status_id (可选)- 如果是回复某一条消息，则在这里指明被回复的消息的ID。source (可选) - 消息来源，使用 POST 方式提交，如果与微博的数据库匹配，网页上将以此格式显示：location (可选) - 最多30个字符，表示发布消息的地点名称 或 一个半角逗号分隔的经纬度坐标。如：北京市海淀区 或者 39.9594049,116.298419。备注：在返回的回复信息，原先回复内容的头部没有自动加上被回复者的昵称，现已增加"自动在回复内容的前面添加'@昵称 '"。

删除消息路径：http://api.t.cnfol.com/statuses/destroy/id.[xml|json]方法：POST参数：id (必需) - 消息的id。示例：http://api.t.cnfol.com/statuses/destroy/6IAZmgy1TzA.xml

他人转发的微博路径：http://api.t.cnfol.com/statuses/retweeted_to_me.[xml|rss]需验证用户参数：count (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/retweeted_to_me.xml?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/retweeted_to_me.xml?since_id=10000max_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/retweeted_to_me.xml?max_id=10000000page (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/retweeted_to_me.json?page=3format (可选）－ 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/retweeted_to_me.json?callback=getStatuses

我转发的微博路径：http://api.t.cnfol.com/statuses/retweeted_by_me.[xml|rss]需验证用户参数：count (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/retweeted_by_me.xml?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/retweeted_by_me.xml?since_id=10000max_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/retweeted_by_me.xml?max_id=10000000page (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/retweeted_by_me.json?page=3format (可选）－ 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/retweeted_by_me.json?callback=getStatuses

我被转发的微博路径：http://api.t.cnfol.com/statuses/retweets_of_me.[xml|rss]需验证用户参数：count (可选) - 消息数，范围 1-20，默认为 20。示例：http://api.t.cnfol.com/statuses/retweets_of_me.xml?count=10since_id (可选) - 仅返回比此 ID 大的消息。示例：http://api.t.cnfol.com/statuses/retweets_of_me.xml?since_id=10000max_id (可选) - 仅返回 ID 小于等于此 ID 的消息。示例：http://api.t.cnfol.com/statuses/retweets_of_me.xml?max_id=10000000page (可选) - 页码，从 1 开始示例：http://api.t.cnfol.com/statuses/retweets_of_me.json?page=3format (可选）－ 消息内容格式，当 format=html 时，返回消息的内容字段是进行@识别，网址识别等后台处理之后的html代码。callback (可选) - JavaScript 函数名，使用 JSON 格式时可用，将 JSON 对象作为参数直接调用示例：http://api.t.cnfol.com/statuses/retweets_of_me.json?callback=getStatuses

转发消息路径：http://api.t.cnfol.com/statuses/retweet/id.[xml|json]需验证用户POST参数：id (必需) - 消息的id。示例：http://api.t.cnfol.com/statuses/retweet/158800.xml

搜索相关的方法

公开搜索路径：http://api.t.cnfol.com/search.[json|xml]参数：q（必须）- 检索串（缺省则为搜索空信息）。cnfol – 表示要搜索的值示例：http://api.t.cnfol.com/search/public_timeline.json?q=cnfol 或 http://api.t.cnfol.com/search/public_timeline.xml?q=cnfolmax_id (可选) - 仅返回 ID 小于此 ID 的消息。示例：http://api.t.cnfol.com/search/public_timeline.xml?q=cnfol&max_id=6IAZmgy1TzA