2/messages/reply
第144行: | 第144行: | ||
} | } | ||
</pre> | </pre> | ||
+ | |||
+ | __NOTOC__ |
2013年9月3日 (二) 12:11的版本
消息回复接口
功能: 消息回复接口,对接收到的指定新消息进行回复
接口调用地址:https://m.api.weibo.com/2/messages/reply.json
HTTP请求方式:POST
是否需要登陆:是
接口请求参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
source | string | true | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
id | long | true | 需要响应的推送消息ID。 |
type | string | true | 需要以何种类型的消息进行响应。text:纯文本。 |
data | string | true | 消息数据,具体内容严格遵循type类型对应格式。必须为json做URLEncode后的字符串格式,采用UTF-8编码。 |
注意事项
- 1、为确保应用及V用户信息安全,此接口必须在服务器端调用;
- 2、调用接口的登录帐号必须为该appkey的所有者,需要使用所有者帐号通过Base Auth的方式;
- 3、如appkey已绑定IP地址,调用接口的请求IP须为绑定的IP;
- 4、指定ID的新消息对应的原接收者已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管;
- 5、指定ID的新消息对应的原接收者已开启推送服务(当前托管即自动开启);
- 6、指定ID的新消息创建时间在72小时内;
- 7、指定的ID消息为“私信、留言”时72小时内可回复三次,为关注、取消关注事件等非私信消息72小时内可回复1次;
- 8、指定ID的新消息对应的原接收者身份发出此消息;
- 9、指定ID的新消息对应的原发送者将收到此消息;
- 10、发送者未被屏蔽或拉黑时消息进私信箱;
蓝V可回复的私信类型
当前支持蓝V回复的私信类型(type)中,data参数支持的参数:
1、纯文本类型私信消息:text
{ "text": "纯文本回复" }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
text | string | true | 要回复的私信文本内容。文本大小必须小于300个汉字。 |
举例: 当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:"%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d"。
则对应的调用为:
curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&id=1307180000*****&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/reply.json" -k
2、图文类型私信消息:articles
{ "articles": [ //最多支持8个图文,建议为1或3个 { "display_name": "两个故事", "summary": "今天讲两个故事,分享给你。谁是公司?谁又是中国人?", "image": "http://storage.mcp.weibo.cn/0JlIv.jpg", "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319" } ] }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
articles:display_name | string | true | 图文的显示名称标题 |
articles:summary | string | true | 图文的文字描述 |
articles:image | string | true | 图文的缩略显示图片,需为JPG、PNG格式,单图及多图第一张推荐使用280*155,多图非第一张推荐使用64*64 |
articles:url | string | true | 图文的URL地址,点击后跳转 |
接口调用失败返回
{ "request": "/2/messages/reply.json", "error_code": "264XX", "error": "error message." }