Weibo Platform Logo

微博开放平台

weibo

Receive Event Push

跳转到： 导航, 搜索
(以“After users taking attention to or cancel the attention to a third Weibo account，or scanning a two-dimension code with parameters, the Weibo server will push this ...”为内容创建页面)
 
(→Taking attention or canceling attention event)
第5行： 第5行：
  
 
==Taking attention or canceling attention event==
 
==Taking attention or canceling attention event==
−
关注/取消关注事件，推送的JSON格式如下：
+
Taking attention or canceling attention，push the JSON format is as follows：
 
<pre>
 
<pre>
 
{
 
{
第24行： 第24行：
 
!colspan="3" scope="col" |<span id="返回值说明">返回值说明</span>
 
!colspan="3" scope="col" |<span id="返回值说明">返回值说明</span>
 
|-
 
|-
−
|style="text-align:center; width: 12%"|属性
+
|style="text-align:center; width: 12%"|Parameters
−
|style="text-align:center;width: 12%"|值的类型
+
|style="text-align:center;width: 12%"|Type
−
|style="text-align:center;"|说明描述
+
|style="text-align:center;"|Description
 
|-
 
|-
 
|type
 
|type
第34行： 第34行：
 
|receiver_id
 
|receiver_id
 
|int64
 
|int64
−
|消息的接收者
+
|Recipient of the message
 
|-
 
|-
 
|sender_id
 
|sender_id
 
|int64
 
|int64
−
|消息的发送者
+
|Sender of the message
 
|-
 
|-
 
|created_at
 
|created_at
 
|string
 
|string
−
|消息创建时间
+
|Message creation time
 
|-
 
|-
 
|text
 
|text
 
|string
 
|string
−
|默认文案。subtype为follow或unfollow时分别为“关注事件消息”、“取消关注事件消息”；
+
|The default copy。subtype is follow or unfollow：“Taking attention event”、“anceling attention event”；
 
|-
 
|-
 
|data
 
|data
 
|string
 
|string
−
|消息内容
+
|Message Content
 
|-
 
|-
 
|data:subtype
 
|data:subtype
 
|string
 
|string
−
|follow：关注事件，unfollow取消关注事件。
+
|follow：Taking attention  ，unfollow：canceling attention event
 
|-
 
|-
 
|}
 
|}

2014年8月6日 (三) 19:42的版本

After users taking attention to or cancel the attention to a third Weibo account，or scanning a two-dimension code with parameters, the Weibo server will push this events to the url which the third Weibo account wrote in the fan service platform. It gives great convenience to developers to send users with welcome messages or unbundling account. The Weibo server will break connection if it cannot receive response in five seconds, and it will send a new request, if not succeed, it will retry three times. To Eliminate message repetitive of the retry, you’d better use FromUserName + CreateTme. If the third server cannot dispose an reply in five seconds, it can directly reply an empty string, the Weibo user will not do anything under this situation and will not begin retrying.

目录

Taking attention or canceling attention event

Taking attention or canceling attention，push the JSON format is as follows： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "关注事件消息",
    "data": {
        "subtype": "follow"
    }
}
返回值说明
Parameters Type Description
type string event
receiver_id int64 Recipient of the message
sender_id int64 Sender of the message
created_at string Message creation time
text string The default copy。subtype is follow or unfollow：“Taking attention event”、“anceling attention event”；
data string Message Content
data:subtype string follow：Taking attention ，unfollow：canceling attention event

Subscribe or unsubscribe event

订阅/取消订阅事件，推送的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订阅事件。


Scanning a two-dimension code with parameters

扫描带参数二维码事件，推送的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，可用来换取二维码图片。


Have been @ message

说明：指定的认证用户需被授予接收“被@消息”权限，此接口才返回“被@消息”，申请可邮件 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


Pushing event when click menu to get messages

点击Click菜单事件，推送的JSON格式如下： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "自定义菜单点击事件消息",
    "data": {
        "subtype": "click",
        "key": "EVENT_KEY"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案，subtype为click时为 "自定义菜单点击事件消息"；
data string 消息内容
data:subtype string click, 自定义菜单点击事件
data:key string 被点击的自定义菜单的key值


Pushing event when click jump url

点击View菜单事件，推送的JSON格式如下： 

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "自定义菜单跳转链接事件消息",
    "data": {
        "subtype": "view",
        "key": "url"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案，subtype为view时为 "自定义菜单跳转链接事件消息"；
data string 消息内容
data:subtype string view, 自定义菜单跳转链接事件消息
data:key string 该按钮设置的url
来自“http://open.weibo.com/wiki/index.php?title=Receive_Event_Push&oldid=13799”

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

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