高级群发接口
(未显示2个用户的14个中间版本) | |||
第2行: | 第2行: | ||
接口调用请求说明: | 接口调用请求说明: | ||
− | URL:https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN | + | URL:https://m.api.weibo.com/2/messages/sendall.json?access_token=ACCESS_TOKEN |
+ | |||
HTTP 请求方式:POST | HTTP 请求方式:POST | ||
− | + | ||
POST数据说明: | POST数据说明: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''文本''' | '''文本''' | ||
<pre> | <pre> | ||
第33行: | 第21行: | ||
</pre> | </pre> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''图文消息''' | '''图文消息''' | ||
第98行: | 第61行: | ||
请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 | 请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 | ||
− | + | =根据UID列表群发= | |
− | + | ||
− | = | + | |
接口调用请求说明: | 接口调用请求说明: | ||
− | URL:https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN | + | URL:https://m.api.weibo.com/2/messages/sendall.json?access_token=ACCESS_TOKEN |
HTTP 请求方式:POST | HTTP 请求方式:POST | ||
POST数据说明: | POST数据说明: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''文本''' | '''文本''' | ||
第134行: | 第81行: | ||
}, | }, | ||
"msgtype":"text" | "msgtype":"text" | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
} | } | ||
</pre> | </pre> | ||
第204行: | 第123行: | ||
</pre> | </pre> | ||
请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 | 请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
第265行: | 第148行: | ||
</pre> | </pre> | ||
− | {| border=" | + | |
+ | |||
+ | <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="2" scope="col" |<span id="返回值说明">返回值说明</span> | ||
+ | |- | ||
+ | |style="text-align:center; width: 12%"|属性 | ||
+ | |style="text-align:center;"|说明描述 | ||
+ | |- | ||
+ | |ToUserName | ||
+ | |群发发起人的uid | ||
+ | |- | ||
+ | |FromUserName | ||
+ | |为空 | ||
+ | |- | ||
+ | |CreateTime | ||
+ | |创建时间 | ||
+ | |- | ||
+ | |MsgType | ||
+ | |Event | ||
+ | |- | ||
+ | |Event | ||
+ | |事件信息,此处为MASSSENDJOBFINISH | ||
+ | |- | ||
+ | |MsgID | ||
+ | |群发的消息ID | ||
+ | |- | ||
+ | |Status | ||
+ | |群发的结构,为“send success”或“send fail”。但send success时,也有可能因用户拒收公众号的消息、系统错误等原因造成少量用户接收失败 | ||
+ | |- | ||
+ | |TotalCount | ||
+ | |group_id下粉丝数,或者uid_list中的粉丝数 | ||
+ | |- | ||
+ | |FilterCount | ||
+ | |过滤(过滤是指特定地区、性别的过滤、用户设置拒收的过滤,用户接收已超规定条数的过滤)后,准备发送的粉丝数,原则上,FilterCount = SentCount + ErrorCount | ||
+ | |- | ||
+ | |SentCount | ||
+ | |发送成功的粉丝数 | ||
|- | |- | ||
− | + | |ErrorCount | |
− | + | |发送失败的粉丝数 | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|} | |} |
2014年7月15日 (二) 16:00的最后版本
根据分组进行群发
接口调用请求说明: URL:https://m.api.weibo.com/2/messages/sendall.json?access_token=ACCESS_TOKEN
HTTP 请求方式:POST
POST数据说明:
文本
{ "filter":{ "group_id":"123" //分组id }, "text":{ "content":"CONTENT" //文本内容 }, "msgtype":"text" }
图文消息
{ "filter":{ "group_id":"123" //分组id }, "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个 ], "msgtype":"articles" }
//返回说明 调用成功时的返回值:
{ "result": true, "msg_id": xxxxx //成功返回true,消息ID }
调用失败时的返回值:
{ "request": "https://m.api.weibo.com/2/messages/sendall", "errcode": "1000XX", "errmsg": "error message." }
请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。
根据UID列表群发
接口调用请求说明: URL:https://m.api.weibo.com/2/messages/sendall.json?access_token=ACCESS_TOKEN HTTP 请求方式:POST
POST数据说明:
文本
{ "touser":[ "uid1", "uid2" ], "text":{ "content":"CONTENT" //文本内容 }, "msgtype":"text" }
图文消息
{ "touser":[ "uid1", "uid2" ], "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个 ], "msgtype":"articles" }
//返回说明 调用成功时的返回值:
{ "result": true, "msg_id": xxxxx //成功返回true,消息ID }
调用失败时的返回值:
{ "request": "https://m.api.weibo.com/2/messages/sendall", "errcode": "1000XX", "errmsg": "error message." }
请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。
事情推送群发结果
由于群发任务提交后,群发任务可能在一定时间后才完成,因此,群发接口调用时,仅会给出群发任务是否提交成功的提示,若群发任务提交成功,则在群发任务结束时,会向开发者在粉丝服务平台填写的开发者URL(callback URL)推送事件。
推送的XML结构如下(发送成功时):
<xml> <ToUserName><![CDATA[gh_3e8adccde292]]></ToUserName> <FromUserName><![CDATA[oR5Gjjl_eiZoUpGozMo7dbBJ362A]]></FromUserName> <CreateTime>1394524295</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[MASSSENDJOBFINISH]]></Event> <MsgID>1988</MsgID> <Status><![CDATA[sendsuccess]]></Status> <TotalCount>100</TotalCount> <FilterCount>80</FilterCount> <SentCount>75</SentCount> <ErrorCount>5</ErrorCount> </xml>
返回值说明 | |
---|---|
属性 | 说明描述 |
ToUserName | 群发发起人的uid |
FromUserName | 为空 |
CreateTime | 创建时间 |
MsgType | Event |
Event | 事件信息,此处为MASSSENDJOBFINISH |
MsgID | 群发的消息ID |
Status | 群发的结构,为“send success”或“send fail”。但send success时,也有可能因用户拒收公众号的消息、系统错误等原因造成少量用户接收失败 |
TotalCount | group_id下粉丝数,或者uid_list中的粉丝数 |
FilterCount | 过滤(过滤是指特定地区、性别的过滤、用户设置拒收的过滤,用户接收已超规定条数的过滤)后,准备发送的粉丝数,原则上,FilterCount = SentCount + ErrorCount |
SentCount | 发送成功的粉丝数 |
ErrorCount | 发送失败的粉丝数 |