微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
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: <pre> { "type": "event", "receiver_id": 1902538057, "sender_id": 2489518277, "created_at": "Mon Jul 16 18:09:20 +0800 2012", "text": "关注事件消息", "data": { "subtype": "follow" } } </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%"|Parameters |style="text-align:center;width: 12%"|Type |style="text-align:center;"|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格式如下: <pre> { "type": "event", "receiver_id": 1902538057, "sender_id": 2489518277, "created_at": "Mon Jul 16 18:09:20 +0800 2012", "text": "订阅事件消息", "data": { "subtype": "subscribe" } } </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 |默认文案。为subscribe或unsubscribe时为触发订阅的私信关键词(如“dy”),非私信触发时(点击订阅按钮)为“订阅事件消息”、“取消订阅事件消息”; |- |data |string |消息内容 |- |data:subtype |string |subscribe订阅事件,unsubscribe订阅事件。 |- |} ==Scanning a two-dimension code with parameters== 扫描带参数二维码事件,推送的JSON格式如下: <pre> { "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", } } </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为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== 说明:指定的认证用户需被授予接收“被@消息”权限,此接口才返回“被@消息”,申请可邮件 [mailto:mingjin@staff.sina.com.cn mingjin@staff.sina.com.cn] 。 <pre> { "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 </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 |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格式如下: <pre> { "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" } } </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为click时为 "自定义菜单点击事件消息"; |- |data |string |消息内容 |- |data:subtype |string |click, 自定义菜单点击事件 |- |data:key |string |被点击的自定义菜单的key值 |- |} ==Pushing event when click jump url== 点击View菜单事件,推送的JSON格式如下: <pre> { "type": "event", "receiver_id": 1902538057, "sender_id": 2489518277, "created_at": "Mon Jul 16 18:09:20 +0800 2012", "text": "自定义菜单跳转链接事件消息", "data": { "subtype": "view", "key": "url" } } </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为view时为 "自定义菜单跳转链接事件消息"; |- |data |string |消息内容 |- |data:subtype |string |view, 自定义菜单跳转链接事件消息 |- |data:key |string |该按钮设置的url |- |}
返回到
Receive Event Push
。
反馈
分享
顶部