发送被动响应消息
(→回复纯文本消息) |
(→回复图文消息) |
||
第58行: | 第58行: | ||
{ | { | ||
"result": true, | "result": true, | ||
− | "receiver_id": | + | "receiver_id":456, |
− | "sender_id": | + | "sender_id":123, |
"type": "articles", | "type": "articles", | ||
"data": { | "data": { | ||
第72行: | 第72行: | ||
] | ] | ||
} | } | ||
+ | } | ||
+ | |||
+ | //返回样例 | ||
+ | { | ||
+ | "result":true, | ||
+ | "sender_id":"123", | ||
+ | "receiver_id":"456", | ||
+ | "type":"articles", | ||
+ | "data":"%7B%22articles%22%3A%5B%7B%22display_name%22%3A%22%E4%B8%A4%E4%B8%AA%E6%95%85%E4%BA%8B%22%2C%22summary%22%3A%22%E4%BB%8A%E5%A4%A9%E8%AE%B2%E4%B8%A4%E4%B8%AA%E6%95%85%E4%BA%8B%EF%BC%8C%E5%88%86%E4%BA%AB%E7%BB%99%E4%BD%A0%E3%80%82%E8%B0%81%E6%98%AF%E5%85%AC%E5%8F%B8%EF%BC%9F%E8%B0%81%E5%8F%88%E6%98%AF%E4%B8%AD%E5%9B%BD%E4%BA%BA%EF%BC%9F%E2%80%8B%22%2C%22image%22%3A%22http%3A%2F%2Fstorage.mcp.weibo.cn%2F0JlIv.jpg%22%2C%22url%22%3A%22http%3A%2F%2Fe.weibo.com%2Fmediaprofile%2Farticle%2Fdetail%3Fuid%3D1722052204%26aid%3D983319%22%7D%5D%7D" | ||
} | } | ||
</pre> | </pre> | ||
第105行: | 第114行: | ||
|图文的URL地址,点击后跳转 | |图文的URL地址,点击后跳转 | ||
|} | |} | ||
− | |||
==位置类型私信消息== | ==位置类型私信消息== |
2014年4月29日 (二) 16:31的版本
对于每一个POST请求,开发者在响应包(Get)中返回特定JSON结构或者XML结构,对该消息进行响应(现支持回复文本、图文消息)。
微博服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次;
关于重试的消息排重,推荐使用FromUserName + CreateTime 排重;
假如开发者无法保证在五秒内处理并回复,可以直接回复空串,微博服务器不会对此作任何处理,并且不会发起重试。这种情况下,可以使用客服消息接口进行异步回复。
回复纯文本消息
如果回复纯文本消息,则返回JSON格式如下: 注意:JSON格式中的data字段内容必须进行UTF8格式的URLEncode
{ "result": true, "receiver_id":456, "sender_id":123, "tpye": "text", "data":"{ "text": "中文消息" }" } //返回样例 { "result":true, "sender_id":"123", "receiver_id":"456", "type":"text", "data":"%7B%22text%22%3A%22%E4%B8%AD%E6%96%87%E6%B6%88%E6%81%AF%22%7D" }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
text | string | true | 要回复的私信文本内容。文本大小必须小于300个汉字。 |
举例: 当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:"%7B%22text%22%3A%20%22%E7%BA%AF%E6%96%87%E6%9C%AC%E5%93%8D%E5%BA%94%22%7D%20"。
回复图文消息
如果回复图文消息,则返回JSON格式如下:
{ "result": true, "receiver_id":456, "sender_id":123, "type": "articles", "data": { "articles": [ { "display_name": "两个故事", "summary": "今天讲两个故事,分享给你。谁是公司?谁又是中国人?", "image": "http://storage.mcp.weibo.cn/0JlIv.jpg", "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319" }, ... //最多支持8个图文,建议为1或3个 ] } } //返回样例 { "result":true, "sender_id":"123", "receiver_id":"456", "type":"articles", "data":"%7B%22articles%22%3A%5B%7B%22display_name%22%3A%22%E4%B8%A4%E4%B8%AA%E6%95%85%E4%BA%8B%22%2C%22summary%22%3A%22%E4%BB%8A%E5%A4%A9%E8%AE%B2%E4%B8%A4%E4%B8%AA%E6%95%85%E4%BA%8B%EF%BC%8C%E5%88%86%E4%BA%AB%E7%BB%99%E4%BD%A0%E3%80%82%E8%B0%81%E6%98%AF%E5%85%AC%E5%8F%B8%EF%BC%9F%E8%B0%81%E5%8F%88%E6%98%AF%E4%B8%AD%E5%9B%BD%E4%BA%BA%EF%BC%9F%E2%80%8B%22%2C%22image%22%3A%22http%3A%2F%2Fstorage.mcp.weibo.cn%2F0JlIv.jpg%22%2C%22url%22%3A%22http%3A%2F%2Fe.weibo.com%2Fmediaprofile%2Farticle%2Fdetail%3Fuid%3D1722052204%26aid%3D983319%22%7D%5D%7D" }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
articles:display_name | string | true | 图文的显示名称标题 |
articles:summary | string | true | 图文的文字描述,大于等于2个图文时,仅显示第一个图文的描述 |
articles:image | string | true | 图文的缩略显示图片,需为JPG、PNG格式,单图及多图第一张推荐使用280*155,多图非第一张推荐使用64*64 |
articles:url | string | true | 图文的URL地址,点击后跳转 |
位置类型私信消息
{ "result": true, "receiver_id":123456, "sender_id":123123, "type": "position", "data": { "longitude": "116.308586", "latitude": "39.982525" } }