Statuses/reply
第8行: | 第8行: | ||
params={{api_args|cid|true|int64|要回复的评论ID。}} | params={{api_args|cid|true|int64|要回复的评论ID。}} | ||
{{api_args|comment|true|string|要回复的评论内容。必须做URLEncode,信息内容不超过140个汉字。}} | {{api_args|comment|true|string|要回复的评论内容。必须做URLEncode,信息内容不超过140个汉字。}} | ||
− | {{api_args|id|true|int64|要评论的微博消息ID}}| | + | {{api_args|id|true|int64|要评论的微博消息ID}} |
+ | {{api_args|without_mention|false|bool|true:回复中自动加入“回复@用户名”,false:回复中不加“回复@用户名”}}| | ||
getParam=| | getParam=| | ||
postParam=-d "cid=4949855625&id=4046214423&comment=wahaha"| | postParam=-d "cid=4949855625&id=4046214423&comment=wahaha"| |
2011年2月28日 (一) 22:50的版本
目录 |
statuses/reply
回复评论。请求必须用POST方式提交。
URL
http://api.t.sina.com.cn/statuses/reply.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
POST
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
cid | true | int64 | 要回复的评论ID。 |
comment | true | string | 要回复的评论内容。必须做URLEncode,信息内容不超过140个汉字。 |
id | true | int64 | 要评论的微博消息ID |
without_mention | false | bool | true:回复中自动加入“回复@用户名”,false:回复中不加“回复@用户名” |
注意事项
- 为防止重复提交,发表的评论与上次发表的评论内容相同的时候,将返回400错误。
- 如果id及cid不存在,将返回400错误
- 如果没有提供cid或cid非法,而id参数正确,则为对微博的评论。发表评论的返回格式参见statuses/comment
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?> <comment> <created_at>Fri Dec 03 10:39:36 +0800 2010</created_at> <id>4977147033</id> <text>回复@zhangwei217245:wakawaka</text> <source> <a href="http://open.t.sina.com.cn">微博开放平台接口</a> </source> <user> <id>1658122963</id> <screen_name>zhangwei217245</screen_name> <name>zhangwei217245</name> <province>11</province> <city>5</city> <location>北京 朝阳区</location> <description>ABCDE</description> <url/> <profile_image_url>http://tp4.sinaimg.cn/1658122963/50/1282754213</profile_image_url> <domain>zhangwei217245</domain> <gender>m</gender> <followers_count>22</followers_count> <friends_count>43</friends_count> <statuses_count>115</statuses_count> <favourites_count>3</favourites_count> <created_at>Tue Nov 03 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> <status> <created_at>Thu Dec 02 17:23:52 +0800 2010</created_at> <id>4023418959</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/> <retweeted_status> <created_at>Thu Dec 02 17:23:03 +0800 2010</created_at> <id>4023402439</id> <text>再看看在哪AGAIN</text> <source> <a href="">微博开放平台接口</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo xmlns:georss="http://www.georss.org/georss"> <georss:point>39.984833 116.310005</georss:point> </geo> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> <user> <id>1658122963</id> <screen_name>zhangwei217245</screen_name> <name>zhangwei217245</name> <province>11</province> <city>5</city> <location>北京 朝阳区</location> <description>ABCDE</description> <url/> <profile_image_url>http://tp4.sinaimg.cn/1658122963/50/1282754213</profile_image_url> <domain>zhangwei217245</domain> <gender>m</gender> <followers_count>22</followers_count> <friends_count>43</friends_count> <statuses_count>113</statuses_count> <favourites_count>3</favourites_count> <created_at>Tue Nov 03 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> </retweeted_status> <annotations/> </status> </user> <status> <created_at>Thu Dec 02 17:14:39 +0800 2010</created_at> <id>4023227965</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>1658122963</id> <screen_name>zhangwei217245</screen_name> <name>zhangwei217245</name> <province>11</province> <city>5</city> <location>北京 朝阳区</location> <description>ABCDE</description> <url/> <profile_image_url>http://tp4.sinaimg.cn/1658122963/50/1282754213</profile_image_url> <domain>zhangwei217245</domain> <gender>m</gender> <followers_count>22</followers_count> <friends_count>43</friends_count> <statuses_count>108</statuses_count> <favourites_count>3</favourites_count> <created_at>Tue Nov 03 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> <retweeted_status> <created_at>Thu Dec 02 17:06:40 +0800 2010</created_at> <id>4023064087</id> <text>abc</text> <source> <a href="">微博开放平台接口</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo xmlns:georss="http://www.georss.org/georss"> <georss:point>39.8765 119.5678</georss:point> </geo> <in_reply_to_status_id/> <in_reply_to_user_id/> <in_reply_to_screen_name/> <thumbnail_pic>http://ww2.sinaimg.cn/thumbnail/6b85067djw6dbydsnam1xj.jpg</thumbnail_pic> <bmiddle_pic>http://ww2.sinaimg.cn/bmiddle/6b85067djw6dbydsnam1xj.jpg</bmiddle_pic> <original_pic>http://ww2.sinaimg.cn/large/6b85067djw6dbydsnam1xj.jpg</original_pic> <user> <id>1803880061</id> <screen_name>LoopB</screen_name> <name>LoopB</name> <province>11</province> <city>8</city> <location>北京 海淀区</location> <description/> <url/> <profile_image_url>http://tp2.sinaimg.cn/1803880061/50/0/0</profile_image_url> <domain/> <gender>f</gender> <followers_count>1</followers_count> <friends_count>1</friends_count> <statuses_count>14</statuses_count> <favourites_count>4</favourites_count> <created_at>Fri Aug 27 00:00:00 +0800 2010</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> </retweeted_status> <annotations/> </status> <reply_comment> <created_at>Thu Dec 02 17:25:25 +0800 2010</created_at> <id>4949855625</id> <text>小新小新。。。我是小浪~~~</text> <user> <id>1658122963</id> <screen_name>zhangwei217245</screen_name> <name>zhangwei217245</name> <province>11</province> <city>5</city> <location>北京 朝阳区</location> <description>ABCDE</description> <url/> <profile_image_url>http://tp4.sinaimg.cn/1658122963/50/1282754213</profile_image_url> <domain>zhangwei217245</domain> <gender>m</gender> <followers_count>22</followers_count> <friends_count>43</friends_count> <statuses_count>115</statuses_count> <favourites_count>3</favourites_count> <created_at>Tue Nov 03 00:00:00 +0800 2009</created_at> <following>false</following> <verified>false</verified> <allow_all_act_msg>false</allow_all_act_msg> <geo_enabled>true</geo_enabled> </user> </reply_comment> </comment>
JSON示例
{ "id" : 4977097789, "text" : "回复@zhangwei217245:walala", "created_at" : "Fri Dec 03 10:37:39 +0800 2010", "source" : "<a href=\"http://open.t.sina.com.cn\" rel=\"nofollow\">微博开放平台接口</a>", "reply_comment" : { "id" : 4949855625, "text" : "小新小新。。。我是小浪~~~", "created_at" : "Thu Dec 02 17:25:25 +0800 2010", "user" : { "name" : "zhangwei217245", "domain" : "zhangwei217245", "geo_enabled" : true, "followers_count" : 22, "statuses_count" : 115, "favourites_count" : 3, "city" : "5", "description" : "ABCDE", "verified" : false, "id" : 1658122963, "gender" : "m", "friends_count" : 43, "screen_name" : "zhangwei217245", "allow_all_act_msg" : false, "following" : false, "url" : "", "profile_image_url" : "http://tp4.sinaimg.cn/1658122963/50/1282754213", "created_at" : "Tue Nov 03 00:00:00 +0800 2009", "province" : "11", "location" : "北京 朝阳区" } }, "user" : { "name" : "zhangwei217245", "domain" : "zhangwei217245", "geo_enabled" : true, "followers_count" : 22, "statuses_count" : 115, "favourites_count" : 3, "city" : "5", "description" : "ABCDE", "verified" : false, "status" : { "created_at" : "Thu Dec 02 17:23:52 +0800 2010", "text" : "哎呀妈呀,终于找到组织了。", "truncated" : false, "retweeted_status" : { "created_at" : "Thu Dec 02 17:23:03 +0800 2010", "text" : "再看看在哪AGAIN", "truncated" : false, "in_reply_to_status_id" : "", "in_reply_to_screen_name" : "", "geo" : { "type" : "Point", "coordinates" : [ 39.984833, 116.310005 ] }, "user" : { "name" : "zhangwei217245", "domain" : "zhangwei217245", "geo_enabled" : true, "followers_count" : 22, "statuses_count" : 113, "favourites_count" : 3, "city" : "5", "description" : "ABCDE", "verified" : false, "id" : 1658122963, "gender" : "m", "friends_count" : 43, "screen_name" : "zhangwei217245", "allow_all_act_msg" : false, "following" : false, "url" : "", "profile_image_url" : "http://tp4.sinaimg.cn/1658122963/50/1282754213", "created_at" : "Tue Nov 03 00:00:00 +0800 2009", "province" : "11", "location" : "北京 朝阳区" }, "favorited" : false, "in_reply_to_user_id" : "", "id" : 4023402439, "source" : "<a href=\"\" rel=\"nofollow\">微博开放平台接口</a>" }, "in_reply_to_status_id" : "", "annotations" : [ ], "in_reply_to_screen_name" : "", "geo" : null, "favorited" : false, "in_reply_to_user_id" : "", "id" : 4023418959, "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" }, "id" : 1658122963, "gender" : "m", "friends_count" : 43, "screen_name" : "zhangwei217245", "allow_all_act_msg" : false, "following" : false, "url" : "", "profile_image_url" : "http://tp4.sinaimg.cn/1658122963/50/1282754213", "created_at" : "Tue Nov 03 00:00:00 +0800 2009", "province" : "11", "location" : "北京 朝阳区" }, "status" : { "created_at" : "Thu Dec 02 17:14:39 +0800 2010", "text" : "哇哈哈。随便输了个经纬度,就跑到海里去发微博了", "truncated" : false, "retweeted_status" : { "created_at" : "Thu Dec 02 17:06:40 +0800 2010", "text" : "abc", "bmiddle_pic" : "http://ww2.sinaimg.cn/bmiddle/6b85067djw6dbydsnam1xj.jpg", "original_pic" : "http://ww2.sinaimg.cn/large/6b85067djw6dbydsnam1xj.jpg", "truncated" : false, "in_reply_to_status_id" : "", "in_reply_to_screen_name" : "", "geo" : { "type" : "Point", "coordinates" : [ 39.8765, 119.5678 ] }, "user" : { "name" : "LoopB", "domain" : "", "geo_enabled" : true, "followers_count" : 1, "statuses_count" : 14, "favourites_count" : 4, "city" : "8", "description" : "", "verified" : false, "id" : 1803880061, "gender" : "f", "friends_count" : 1, "screen_name" : "LoopB", "allow_all_act_msg" : false, "following" : false, "url" : "", "profile_image_url" : "http://tp2.sinaimg.cn/1803880061/50/0/0", "created_at" : "Fri Aug 27 00:00:00 +0800 2010", "province" : "11", "location" : "北京 海淀区" }, "favorited" : false, "thumbnail_pic" : "http://ww2.sinaimg.cn/thumbnail/6b85067djw6dbydsnam1xj.jpg", "in_reply_to_user_id" : "", "id" : 4023064087, "source" : "<a href=\"\" rel=\"nofollow\">微博开放平台接口</a>" }, "in_reply_to_status_id" : "", "annotations" : [ ], "in_reply_to_screen_name" : "", "geo" : null, "user" : { "name" : "zhangwei217245", "domain" : "zhangwei217245", "geo_enabled" : true, "followers_count" : 22, "statuses_count" : 108, "favourites_count" : 3, "city" : "5", "description" : "ABCDE", "verified" : false, "id" : 1658122963, "gender" : "m", "friends_count" : 43, "screen_name" : "zhangwei217245", "allow_all_act_msg" : false, "following" : false, "url" : "", "profile_image_url" : "http://tp4.sinaimg.cn/1658122963/50/1282754213", "created_at" : "Tue Nov 03 00:00:00 +0800 2009", "province" : "11", "location" : "北京 朝阳区" }, "favorited" : false, "in_reply_to_user_id" : "", "id" : 4023227965, "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>" } }
其他
PHP示例
请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:
//Statuses/reply $c = new WeiboClient( WB_AKEY , WB_SKEY , $_SESSION['last_key']['oauth_token'] , $_SESSION['last_key']['oauth_token_secret'] ); //to be filled in $sid='sid'; $comment='comment'; $cid='cid'; $msg=$c->reply($sid, $comment,$cid); echo($msg['text'];