Weibo Platform Logo

微博开放平台

weibo

接收事件推送

跳转到： 导航, 搜索
(以“用户在关注与取消关注公众号时，微信会把这个事件推送到开发者填写的URL。方便开发者给用户下发欢迎消息或者做帐号的解...”为内容创建页面)
 
第61行： 第61行：
 
|}
 
|}
  
−
==订阅/取消订阅事件事件==
+
==订阅/取消订阅事件==
 
订阅/取消订阅事件，推送的JSON格式如下：
 
订阅/取消订阅事件，推送的JSON格式如下：
 
<pre>
 
<pre>
第127行： 第127行：
 
     "data": {
 
     "data": {
 
         "subtype": "scan_follow",
 
         "subtype": "scan_follow",
−
         "key": "EVENT_KEY",
+
         "key": "action_name_scene_id",
 
         "ticket": "TICKET",
 
         "ticket": "TICKET",
 
     }
 
     }
第172行： 第172行：
 
|data:key
 
|data:key
 
|string
 
|string
−
|事件KEY值，格式为action_name_scene_id，也就是说以QR_SCENE或者qr_scene_或者为前缀，后面为二维码的scene_id；qrscene_为前缀，后面为二维码的参数值
+
|事件KEY值，格式为action_name_scene_id，也就是说以action_name为前缀，后面为二维码的scene_id；
 
|-
 
|-
 
|data:ticket
 
|data:ticket
第179行： 第179行：
 
|}
 
|}
  
−
==关注/取消关注事件==
 
  
−
关注/取消关注事件，推送的JSON格式如下：
+
==被@消息==
−
<pre>
+
说明：指定的认证用户需被授予接收“被@消息”权限，此接口才返回“被@消息”，申请可邮件 [mailto:mingjin@staff.sina.com.cn mingjin@staff.sina.com.cn] 。
−
{
+
−
    "type": "event",
+
−
    "receiver_id": 1902538057,
+
−
    "sender_id": 2489518277,
+
−
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
+
−
    "text": "事件消息",
+
−
    "data": {
+
−
        "subtype": "EVENT",
+
−
        "key": "EVENT_KEY",
+
−
        "ticket": "TICKET",
+
−
    }
+
−
}
+
−
</pre>
+
−
<div class="wiki_kit">
+
−
 
+
−
{|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table"
+
−
<html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html>
+
−
!colspan="3" scope="col" |<span id="返回值说明">返回值说明</span>
+
−
|-
+
−
|style="text-align:center; width: 12%"|属性
+
−
|style="text-align:center;width: 12%"|值的类型
+
−
|style="text-align:center;"|说明描述
+
−
|-
+
−
|type
+
−
|string
+
−
|event
+
−
|-
+
−
|receiver_id
+
−
|int64
+
−
|消息的接收者
+
−
|-
+
−
|sender_id
+
−
|int64
+
−
|消息的发送者
+
−
|-
+
−
|created_at
+
−
|string
+
−
|消息创建时间
+
−
|-
+
−
|text
+
−
|string
+
−
|默认文案。subtype为follow或unfollow时分别为“关注事件消息”、“取消关注事件消息”；为subscribe或unsubscribe时为触发订阅的私信关键词（如“dy”），非私信触发时（点击订阅按钮）为“订阅事件消息”、“取消订阅事件消息”；subtype为scan或scan_follow时为“扫描二维码”；
+
−
|-
+
−
|data
+
−
|string
+
−
|消息内容
+
−
|-
+
−
|data:subtype
+
−
|string
+
−
|follow：关注事件，unfollow取消关注事件，subscribe订阅事件，unsubscribe订阅事件。scan和scan_follow为二维码扫描事件。
+
−
|-
+
−
|data:key
+
−
|string
+
−
|subtype为follow、unfollow、subscribe或unsubscribe时不返回
+
−
|-
+
−
|data:ticket
+
−
|string
+
−
|subtype为scan和scan_follow时才返回
+
−
|}
+
−
 
+
−
==关注/取消关注事件==
+
−
 
+
−
关注/取消关注事件，推送的JSON格式如下：
+
−
<pre>
+
−
{
+
−
    "type": "event",
+
−
    "receiver_id": 1902538057,
+
−
    "sender_id": 2489518277,
+
−
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
+
−
    "text": "事件消息",
+
−
    "data": {
+
−
        "subtype": "EVENT",
+
−
        "key": "EVENT_KEY",
+
−
        "ticket": "TICKET",
+
−
    }
+
−
}
+
−
</pre>
+
−
<div class="wiki_kit">
+
−
 
+
−
{|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table"
+
−
<html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html>
+
−
!colspan="3" scope="col" |<span id="返回值说明">返回值说明</span>
+
−
|-
+
−
|style="text-align:center; width: 12%"|属性
+
−
|style="text-align:center;width: 12%"|值的类型
+
−
|style="text-align:center;"|说明描述
+
−
|-
+
−
|type
+
−
|string
+
−
|event
+
−
|-
+
−
|receiver_id
+
−
|int64
+
−
|消息的接收者
+
−
|-
+
−
|sender_id
+
−
|int64
+
−
|消息的发送者
+
−
|-
+
−
|created_at
+
−
|string
+
−
|消息创建时间
+
−
|-
+
−
|text
+
−
|string
+
−
|默认文案。subtype为follow或unfollow时分别为“关注事件消息”、“取消关注事件消息”；为subscribe或unsubscribe时为触发订阅的私信关键词（如“dy”），非私信触发时（点击订阅按钮）为“订阅事件消息”、“取消订阅事件消息”；subtype为scan或scan_follow时为“扫描二维码”；
+
−
|-
+
−
|data
+
−
|string
+
−
|消息内容
+
−
|-
+
−
|data:subtype
+
−
|string
+
−
|follow：关注事件，unfollow取消关注事件，subscribe订阅事件，unsubscribe订阅事件。scan和scan_follow为二维码扫描事件。
+
−
|-
+
−
|data:key
+
−
|string
+
−
|subtype为follow、unfollow、subscribe或unsubscribe时不返回
+
−
|-
+
−
|data:ticket
+
−
|string
+
−
|subtype为scan和scan_follow时才返回
+
−
|}
+
  
−
<h3>被@消息：mention</h3>
 
−
说明：指定的认证用户需被授予接收“被@消息”权限，此接口才返回“被@消息”，申请可邮件 [mailto:open_api@sina.com open_api@sina.com] 。
 
 
<pre>
 
<pre>
 
{
 
{

2014年4月20日 (日) 16:09的版本

用户在关注与取消关注公众号时，微信会把这个事件推送到开发者填写的URL。方便开发者给用户下发欢迎消息或者做帐号的解绑。

微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次

关于重试的消息排重，推荐使用FromUserName + CreateTime 排重。

假如服务器无法保证在五秒内处理并回复，可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。

目录

关注/取消关注事件

关注/取消关注事件，推送的JSON格式如下： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "关注事件消息",
    "data": {
        "subtype": "follow"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案。subtype为follow或unfollow时分别为“关注事件消息”、“取消关注事件消息”；
data string 消息内容
data:subtype string follow：关注事件，unfollow取消关注事件。

订阅/取消订阅事件

订阅/取消订阅事件，推送的JSON格式如下： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "订阅事件消息",
    "data": {
        "subtype": "subscribe"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案。为subscribe或unsubscribe时为触发订阅的私信关键词（如“dy”），非私信触发时（点击订阅按钮）为“订阅事件消息”、“取消订阅事件消息”；
data string 消息内容
data:subtype string subscribe订阅事件，unsubscribe订阅事件。


扫描带参数二维码事件

扫描带参数二维码事件，推送的JSON格式如下： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "扫描二维码",
    "data": {
        "subtype": "scan_follow",
        "key": "action_name_scene_id",
        "ticket": "TICKET",
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案。subtype为scan或scan_follow时为“扫描二维码”；
data string 消息内容
data:subtype string scan和scan_follow为二维码扫描事件。
data:key string 事件KEY值，格式为action_name_scene_id，也就是说以action_name为前缀，后面为二维码的scene_id；
data:ticket string 二维码的ticket，可用来换取二维码图片。


被@消息

说明：指定的认证用户需被授予接收“被@消息”权限，此接口才返回“被@消息”，申请可邮件 mingjin@staff.sina.com.cn 。 

{
    "type": "mention",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "被@的微博或评论文本信息",
    "data": {
        "subtype": "MENTION_TYPE,
        "key": "MENTION_KEY"
    }
}

// 默认仅返回可信用户的@，如需返回所有用户@，认证用户可访问此链接设置：http://account.weibo.com/set/message
返回值说明
属性 值的类型 说明描述
type string mention
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 被@的微博或评论文本信息
data string 消息内容
data:subtype string status：@的微博，comment：@的评论
data:key string 当subtype为status时为微博ID，为comment时为评论ID
来自“http://open.weibo.com/wiki/index.php?title=%E6%8E%A5%E6%94%B6%E4%BA%8B%E4%BB%B6%E6%8E%A8%E9%80%81&oldid=12792”

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA