发送被动响应消息
(→位置类型私信消息) |
|||
第106行: | 第106行: | ||
"receiver_id":123456, | "receiver_id":123456, | ||
"sender_id":123123, | "sender_id":123123, | ||
− | "type": " | + | "type": "position", |
"data": { | "data": { | ||
"longitude": "116.308586", | "longitude": "116.308586", |
2014年4月21日 (一) 00:50的版本
对于每一个POST请求,开发者在响应包(Get)中返回特定JSON结构或者XML结构,对该消息进行响应(现支持回复文本、图文消息)。
微博服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次;
关于重试的消息排重,推荐使用FromUserName + CreateTime 排重;
假如开发者无法保证在五秒内处理并回复,可以直接回复空串,微博服务器不会对此作任何处理,并且不会发起重试。这种情况下,可以使用客服消息接口进行异步回复。
回复纯文本消息
如果回复纯文本消息,则返回JSON格式如下: 注意:JSON格式中的data字段内容必须进行UTF8格式的URLEncode
{ "result": true, "receiver_id":123456, "sender_id":123123, "tpye": "text", "data":"{ "text": "你好" }" }
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":123456, "sender_id":123123, "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个 ] } }
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" } }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
longitude | string | true | 经度 |
latitude | string | true | 纬度 |