Statuses/repost timeline
(创建新页面为 '== statuses/update == 发布一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与当前最新信息一样话,将会被忽略。 === URL=…') |
(→statuses/update) |
||
第1行: | 第1行: | ||
− | == statuses/ | + | ==statuses/repost_timeline == |
− | + | 返回一条原创微博的最新n条转发微博信息。非原创微博无法进行查询。 | |
=== URL=== | === URL=== | ||
− | http://api.t.sina.com.cn/statuses/ | + | http://api.t.sina.com.cn/statuses/repost_timeline.format |
=== 格式=== | === 格式=== | ||
第9行: | 第9行: | ||
=== HTTP请求方式=== | === HTTP请求方式=== | ||
− | + | GET | |
=== 是否需要身份验证=== | === 是否需要身份验证=== | ||
第18行: | 第18行: | ||
=== 请求参数=== | === 请求参数=== | ||
− | * | + | *id: (必选)原创微博ID. 返回转发这个微博的转发微博列表。 |
− | + | 示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?id=123456 | |
− | + | *since_id: 微博信息ID. 只返回ID比since_id大(比since_id时间晚的)的微博信息内容。 | |
− | * | + | 示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?since_id=12345 |
− | * | + | *max_id: 微博信息ID. 返回ID不大于max_id的微博信息内容。 |
− | + | 示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?max_id=54321 | |
− | + | *count: 每次返回的最大记录数,不能超过200,默认20. | |
− | + | 示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?count=5 | |
− | + | *page: 返回结果的页序号, 默认1 | |
− | * | + | 示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?page=3 |
− | + | ||
− | + | ||
=== 返回结果 === | === 返回结果 === | ||
注意geo信息仅对有地理位置的微博才有返回 | 注意geo信息仅对有地理位置的微博才有返回 | ||
XML示例: | XML示例: | ||
− | + | <?xml version="1.0" encoding="UTF-8"?> | |
+ | <statuses> | ||
<status> | <status> | ||
− | <created_at> | + | <created_at>Mon Nov 15 17:51:22 +0800 2010</created_at> |
− | <id> | + | <id>3660618965</id> |
− | <text> | + | <text>转发微博。</text> |
<source> | <source> | ||
− | <a href="http://t.sina.com.cn"> | + | <a href="http://t.sina.com.cn">新浪微博</a> |
</source> | </source> | ||
<favorited>false</favorited> | <favorited>false</favorited> | ||
<truncated>false</truncated> | <truncated>false</truncated> | ||
− | <geo | + | <geo/> |
− | + | <in_reply_to_status_id/> | |
− | + | <in_reply_to_user_id/> | |
− | <in_reply_to_status_id | + | <in_reply_to_screen_name/> |
− | <in_reply_to_user_id | + | |
− | <in_reply_to_screen_name | + | |
<user> | <user> | ||
− | <id> | + | <id>1734528095</id> |
− | <screen_name> | + | <screen_name>jkl0000</screen_name> |
− | <name> | + | <name>jkl0000</name> |
− | <province> | + | <province>11</province> |
<city>1000</city> | <city>1000</city> | ||
− | <location> | + | <location>北京</location> |
− | <description> | + | <description>abcdef</description> |
− | <url>http://blog.sina.com.cn</url> | + | <url>http://blog.sina.com.cn/jkl0000</url> |
− | <profile_image_url>http://tp4.sinaimg.cn/ | + | <profile_image_url>http://tp4.sinaimg.cn/1734528095/50/1284023727/1</profile_image_url> |
− | <domain | + | <domain/> |
− | <gender> | + | <gender>m</gender> |
− | <followers_count> | + | <followers_count>44</followers_count> |
− | <friends_count> | + | <friends_count>158</friends_count> |
− | <statuses_count> | + | <statuses_count>772</statuses_count> |
<favourites_count>0</favourites_count> | <favourites_count>0</favourites_count> | ||
− | <created_at> | + | <created_at>Mon Apr 26 00:00:00 +0800 2010</created_at> |
<following>false</following> | <following>false</following> | ||
<verified>false</verified> | <verified>false</verified> | ||
− | <allow_all_act_msg> | + | <allow_all_act_msg>true</allow_all_act_msg> |
− | <geo_enabled> | + | <geo_enabled>true</geo_enabled> |
</user> | </user> | ||
+ | <retweeted_status> | ||
+ | <created_at>Wed Nov 10 14:44:58 +0800 2010</created_at> | ||
+ | <id>3553819645</id> | ||
+ | <text>发现一件神奇的事情</text> | ||
+ | <source> | ||
+ | <a href="http://t.sina.com.cn">新浪微博</a> | ||
+ | </source> | ||
+ | <favorited>false</favorited> | ||
+ | <truncated>false</truncated> | ||
+ | <geo/> | ||
+ | <in_reply_to_status_id/> | ||
+ | <in_reply_to_user_id/> | ||
+ | <in_reply_to_screen_name/> | ||
+ | <user> | ||
+ | <id>1822257145</id> | ||
+ | <screen_name>wh_liang</screen_name> | ||
+ | <name>wh_liang</name> | ||
+ | <province>11</province> | ||
+ | <city>8</city> | ||
+ | <location>北京 海淀区</location> | ||
+ | <description/> | ||
+ | <url>http://1</url> | ||
+ | <profile_image_url>http://tp2.sinaimg.cn/1822257145/50/1285426565/0</profile_image_url> | ||
+ | <domain>liangwenhhong</domain> | ||
+ | <gender>f</gender> | ||
+ | <followers_count>57</followers_count> | ||
+ | <friends_count>77</friends_count> | ||
+ | <statuses_count>44</statuses_count> | ||
+ | <favourites_count>3</favourites_count> | ||
+ | <created_at>Tue Sep 21 00:00:00 +0800 2010</created_at> | ||
+ | <following>false</following> | ||
+ | <verified>false</verified> | ||
+ | <allow_all_act_msg>true</allow_all_act_msg> | ||
+ | <geo_enabled>true</geo_enabled> | ||
+ | </user> | ||
+ | </retweeted_status> | ||
</status> | </status> | ||
+ | </statuses> | ||
+ | |||
JSON示例: | JSON示例: | ||
− | { "created_at":" | + | [ |
− | + | { | |
− | + | "created_at": "Mon Nov 15 17:51:22 +0800 2010", | |
− | + | "favorited": false, | |
− | + | "geo": null, | |
− | + | "id": 3660618965, | |
− | + | "in_reply_to_screen_name": "", | |
− | + | "in_reply_to_status_id": "", | |
− | + | "in_reply_to_user_id": "", | |
− | + | "retweeted_status": { | |
− | + | "created_at": "Wed Nov 10 14:44:58 +0800 2010", | |
− | + | "favorited": false, | |
− | + | "geo": null, | |
− | + | "id": 3553819645, | |
− | + | "in_reply_to_screen_name": "", | |
− | + | "in_reply_to_status_id": "", | |
− | + | "in_reply_to_user_id": "", | |
− | + | "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", | |
− | + | "text": "\u53d1\u73b0\u4e00\u4ef6\u795e\u5947\u7684\u4e8b\u60c5\uff0c\u6211\u7684\u7535\u8bdd\u53f7\u7801\u88ab\u7cfb\u7edf\u5c4f\u853d\u4e86\uff0c\u4e0d\u80fd\u53d1\u9001\uff01\uff01", | |
− | + | "truncated": false, | |
− | + | "user": { | |
− | + | "allow_all_act_msg": true, | |
− | + | "city": "8", | |
− | + | "created_at": "Tue Sep 21 00:00:00 +0800 2010", | |
− | + | "description": "", | |
− | + | "domain": "liangwenhhong", | |
− | + | "favourites_count": 3, | |
− | + | "followers_count": 57, | |
− | + | "following": false, | |
− | + | "friends_count": 77, | |
− | + | "gender": "f", | |
− | + | "geo_enabled": true, | |
− | + | "id": 1822257145, | |
− | + | "location": "\u5317\u4eac \u6d77\u6dc0\u533a", | |
+ | "name": "wh_liang", | ||
+ | "profile_image_url": "http://tp2.sinaimg.cn/1822257145/50/1285426565/0", | ||
+ | "province": "11", | ||
+ | "screen_name": "wh_liang", | ||
+ | "statuses_count": 44, | ||
+ | "url": "http://1", | ||
+ | "verified": false | ||
+ | } | ||
+ | }, | ||
+ | "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", | ||
+ | "text": "\u8f6c\u53d1\u5fae\u535a\u3002", | ||
+ | "truncated": false, | ||
+ | "user": { | ||
+ | "allow_all_act_msg": true, | ||
+ | "city": "1000", | ||
+ | "created_at": "Mon Apr 26 00:00:00 +0800 2010", | ||
+ | "description": "abcdef", | ||
+ | "domain": "", | ||
+ | "favourites_count": 0, | ||
+ | "followers_count": 44, | ||
+ | "following": false, | ||
+ | "friends_count": 158, | ||
+ | "gender": "m", | ||
+ | "geo_enabled": true, | ||
+ | "id": 1734528095, | ||
+ | "location": "\u5317\u4eac", | ||
+ | "name": "jkl0000", | ||
+ | "profile_image_url": "http://tp4.sinaimg.cn/1734528095/50/1284023727/1", | ||
+ | "province": "11", | ||
+ | "screen_name": "jkl0000", | ||
+ | "statuses_count": 772, | ||
+ | "url": "http://blog.sina.com.cn/jkl0000", | ||
+ | "verified": false | ||
+ | } | ||
+ | } | ||
+ | ] | ||
+ | |||
=== 使用示例=== | === 使用示例=== |
2010年11月15日 (一) 18:09的版本
目录 |
statuses/repost_timeline
返回一条原创微博的最新n条转发微博信息。非原创微博无法进行查询。
URL
http://api.t.sina.com.cn/statuses/repost_timeline.format
格式
xml, json
HTTP请求方式
GET
是否需要身份验证
true
请求数限制
true
请求参数
- id: (必选)原创微博ID. 返回转发这个微博的转发微博列表。
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?id=123456
- since_id: 微博信息ID. 只返回ID比since_id大(比since_id时间晚的)的微博信息内容。
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?since_id=12345
- max_id: 微博信息ID. 返回ID不大于max_id的微博信息内容。
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?max_id=54321
- count: 每次返回的最大记录数,不能超过200,默认20.
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?count=5
- page: 返回结果的页序号, 默认1
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?page=3
返回结果
注意geo信息仅对有地理位置的微博才有返回 XML示例:
<?xml version="1.0" encoding="UTF-8"?>
<statuses>
<status> <created_at>Mon Nov 15 17:51:22 +0800 2010</created_at> <id>3660618965</id> <text>转发微博。</text> <source> <a href="http://t.sina.com.cn">新浪微博</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> <user> <id>1734528095</id> <screen_name>jkl0000</screen_name> <name>jkl0000</name> <province>11</province> <city>1000</city> <location>北京</location> <description>abcdef</description> <url>http://blog.sina.com.cn/jkl0000</url> <profile_image_url>http://tp4.sinaimg.cn/1734528095/50/1284023727/1</profile_image_url> <domain/> <gender>m</gender> <followers_count>44</followers_count> <friends_count>158</friends_count> <statuses_count>772</statuses_count> <favourites_count>0</favourites_count> <created_at>Mon Apr 26 00:00:00 +0800 2010</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>true</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> <retweeted_status> <created_at>Wed Nov 10 14:44:58 +0800 2010</created_at> <id>3553819645</id> <text>发现一件神奇的事情</text> <source> <a href="http://t.sina.com.cn">新浪微博</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> <user> <id>1822257145</id> <screen_name>wh_liang</screen_name> <name>wh_liang</name> <province>11</province> <city>8</city> <location>北京 海淀区</location> <description/> <url>http://1</url> <profile_image_url>http://tp2.sinaimg.cn/1822257145/50/1285426565/0</profile_image_url> <domain>liangwenhhong</domain> <gender>f</gender> <followers_count>57</followers_count> <friends_count>77</friends_count> <statuses_count>44</statuses_count> <favourites_count>3</favourites_count> <created_at>Tue Sep 21 00:00:00 +0800 2010</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>true</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> </retweeted_status> </status>
</statuses>
JSON示例:
[ { "created_at": "Mon Nov 15 17:51:22 +0800 2010", "favorited": false, "geo": null, "id": 3660618965, "in_reply_to_screen_name": "", "in_reply_to_status_id": "", "in_reply_to_user_id": "", "retweeted_status": { "created_at": "Wed Nov 10 14:44:58 +0800 2010", "favorited": false, "geo": null, "id": 3553819645, "in_reply_to_screen_name": "", "in_reply_to_status_id": "", "in_reply_to_user_id": "", "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", "text": "\u53d1\u73b0\u4e00\u4ef6\u795e\u5947\u7684\u4e8b\u60c5\uff0c\u6211\u7684\u7535\u8bdd\u53f7\u7801\u88ab\u7cfb\u7edf\u5c4f\u853d\u4e86\uff0c\u4e0d\u80fd\u53d1\u9001\uff01\uff01", "truncated": false, "user": { "allow_all_act_msg": true, "city": "8", "created_at": "Tue Sep 21 00:00:00 +0800 2010", "description": "", "domain": "liangwenhhong", "favourites_count": 3, "followers_count": 57, "following": false, "friends_count": 77, "gender": "f", "geo_enabled": true, "id": 1822257145, "location": "\u5317\u4eac \u6d77\u6dc0\u533a", "name": "wh_liang", "profile_image_url": "http://tp2.sinaimg.cn/1822257145/50/1285426565/0", "province": "11", "screen_name": "wh_liang", "statuses_count": 44, "url": "http://1", "verified": false } }, "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", "text": "\u8f6c\u53d1\u5fae\u535a\u3002", "truncated": false, "user": { "allow_all_act_msg": true, "city": "1000", "created_at": "Mon Apr 26 00:00:00 +0800 2010", "description": "abcdef", "domain": "", "favourites_count": 0, "followers_count": 44, "following": false, "friends_count": 158, "gender": "m", "geo_enabled": true, "id": 1734528095, "location": "\u5317\u4eac", "name": "jkl0000", "profile_image_url": "http://tp4.sinaimg.cn/1734528095/50/1284023727/1", "province": "11", "screen_name": "jkl0000", "statuses_count": 772, "url": "http://blog.sina.com.cn/jkl0000", "verified": false } }
]
使用示例
- xml:
- curl -u uid:password -d 'source=appkey&status=playing with cURL and the SinaAPI&annotations=[{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}]' http://api.t.sina.com.cn/statuses/update.xml
- json:
- curl -u uid:password -d 'source=appkey&status=playing with cURL and the Sina API&annotations=[{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}]' http://api.t.sina.com.cn/statuses/update.json