Statuses/reply
(→返回结果) |
(→statuses/reply) |
||
第6行: | 第6行: | ||
=== 格式=== | === 格式=== | ||
− | xml, json | + | xml, json |
=== HTTP请求方式=== | === HTTP请求方式=== |
2010年9月19日 (日) 14:45的版本
目录 |
statuses/reply
对一条微博评论信息进行回复。请求必须用POST方式提交。为防止重复,发布的信息与最后一条评论/回复信息一样话,将会被忽略。
URL
curl http://api.t.sina.com.cn/statuses/reply.format
格式
xml, json
HTTP请求方式
POST
是否需要身份验证
true
请求数限制
true
请求参数
- id 必填参数, 要评论的微博id
- cid 必填参数, 要评论的评论id 如没有或非法则为对微博的评论
- comment. 必填参数, 评论内容。必须做URLEncode,信息内容不超过140个汉字
使用说明
- 如果没有登录或参数错误,将返回403错误
- 如果id不存在,将返回400错误
- 系统将忽略重复发布的评论信息。每次发布将比较最后一条发布评论消息,如果一样将被忽略。
返回结果
XML示例:
<?xml version="1.0" encoding="UTF-8"?> <comment> <created_at>Fri Jan 08 13:45:07 +0800 2010</created_at> <id>203099</id> <text>dddddddddddd</text> <source> <a id="10013" href="http://t.sina.com.cn">SinaDestTop</a> </source> <user> <id>11055</id> <screen_name>name_11055</screen_name> <name>name_11055</name> <province>0</province> <city>0</city> <location></location> <description></description> <url></url> <profile_image_url>http://tp4.sinaimg.cn/11055/50/0</profile_image_url> <domain>11055</domain> <gender></gender> <followers_count>24</followers_count> <friends_count>51</friends_count> <statuses_count>0</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at> <following>false</following> <verified>false</verified> <geo_enabled>false</geo_enabled> </user> <status> <created_at>Fri Jan 08 10:18:05 +0800 2010</created_at> <id>142314</id> <text>lsdjfl55</text> <source> <a id="10013" href="http://t.sina.com.cn">SinaDestTop</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo/> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <user> <id>11075</id> <screen_name>name_11075</screen_name> <name>name_11075</name> <province>0</province> <city>0</city> <location></location> <description></description> <url></url> <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url> <domain>11075</domain> <gender></gender> <followers_count>28</followers_count> <friends_count>50</friends_count> <statuses_count>0</statuses_count> <favourites_count>34</favourites_count> <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at> <following>false</following> <verified>true</verified> <geo_enabled>false</geo_enabled> </user> </status> <reply_comment> <created_at>Fri Jan 08 11:58:10 +0800 2010</created_at> <id>203097</id> <text>dddddddddddd</text> <source> <a id="10013" href="http://t.sina.com.cn">SinaDestTop</a> </source> <user> <id>11055</id> <screen_name>name_11055</screen_name> <name>name_11055</name> <province>0</province> <city>0</city> <location></location> <description></description> <profile_image_url>http://tp4.sinaimg.cn/11055/50/0</profile_image_url> <domain>11055</domain> <gender></gender> <followers_count>24</followers_count> <friends_count>51</friends_count> <statuses_count>0</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at> <following>false</following> <verified>false</verified> <geo_enabled>false</geo_enabled> </user> </reply_comment> </comment>
JSON示例:
{ "created_at":"Fri Jan 08 11:58:10 +0800 2010", "id":203097, "text":"dddddddddddd", "source":"<a id=\"10013\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">SinaDestTop</a>", "user": {"id":11055, "screen_name":"name_11055", "name":"name_11055", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp4.sinaimg.cn/11055/50/0", "domain":"11055", "followers_count":24, "friends_count":51, "statuses_count":0, "favourites_count":0, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":false}, "status":{"created_at":"Fri Jan 08 10:18:05 +0800 2010", "id":142314, "text":"lsdjfl55", "source":"<a id=\"10013\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">SinaDestTop</a>", "favorited":false, "truncated":false, "in_reply_to_status_id":"", "in_reply_to_user_id":"", "in_reply_to_screen_name":"", "geo":null, "user":{"id":11075, "screen_name":"name_11075", "name":"name_11075", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0", "domain":"11075", "followers_count":28, "friends_count":50, "statuses_count":0, "favourites_count":34, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":true} }, "reply_comment": {"created_at":"Fri Jan 08 11:55:56 +0800 2010", "id":203094, "text":"ccccccc", "source":"<a id=\"10013\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">SinaDestTop</a>", "user":{"id":11055, "screen_name":"name_11055", "name":"name_11055", "province":"0", "city":"0", "location":"", "description":"", "url":"", "profile_image_url":"http://tp4.sinaimg.cn/11055/50/0", "domain":"11055", "followers_count":24, "friends_count":51, "statuses_count":0, "favourites_count":0, "created_at":"Thu Jan 01 08:00:00 +0800 1970", "following":false, "geo_enabled":false, "verified":false} } }
字段说明 - status
- created_at: 创建时间
- 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,如果不是转发,则没有此字段
字段说明 - user
- id: 用户UID
- screen_name: 微博昵称
- name: 友好显示名称,同微博昵称
- province: 省份编码(参考省份编码表)
- city: 城市编码(参考城市编码表)
- location:地址
- description: 个人描述
- url: 用户博客地址
- profile_image_url: 自定义图像
- domain: 用户个性化URL
- gender: 性别,m--男,f--女,n--未知
- followers_count: 粉丝数
- friends_count: 关注数
- statuses_count: 微博数
- favourites_count: 收藏数
- created_at: 创建时间
- following: 是否已关注(此特性暂不支持)
- verified: 加V标示,是否微博认证用户
字段说明 - comment
- id: 评论ID
- text: 评论内容
- source: 评论来源
- favorited: 是否收藏
- truncated: 是否被截断
- created_at: 评论时间
- user: 评论人信息,结构参考user
- status: 评论的微博,结构参考status
- reply_comment 评论来源,数据结构跟comment一致
使用示例
需修改appkey
- xml:
curl -u uid:password -d "source=appkey&id=12345&status=playing with cURL and the Sina API" http://api.t.sina.com.cn/statuses/reply.xml
- json:
curl -u uid:password -d "source=appkey&id=12345&status=playing with cURL and the Sina API" http://api.t.sina.com.cn/statuses/reply.json
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'];