2/messages/post
(未显示1个用户的7个中间版本) | |||
第1行: | 第1行: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=私信订阅群发接口= | =私信订阅群发接口= | ||
功能: | 功能: | ||
− | + | 私信订阅群发接口,V用户可通过此接口给自己的订阅用户群发私信 | |
− | 接口调用地址:https://api.weibo.com/2/messages/post.json | + | 接口调用地址:https://m.api.weibo.com/2/messages/post.json |
第58行: | 第50行: | ||
|string | |string | ||
|true | |true | ||
− | | | + | |需要以何种消息类型发送。text:纯文本,articles:图文 |
|- | |- | ||
|data | |data | ||
第69行: | 第61行: | ||
*1,当指定的sender_id不是当前登录用户时: | *1,当指定的sender_id不是当前登录用户时: | ||
**当前登录用户必须为当前应用的所有者; | **当前登录用户必须为当前应用的所有者; | ||
− | * | + | *2,指定的sender_id用户已指定当前应用为其开发,且指定的sender_id用户已开启“[[粉丝服务开发模式指南|开发模式]]”; |
− | * | + | *3,当指定sender_id认证用户为媒体类型时,发送失败; |
*4,指定的接收者必须为sender_id用户的订阅用户: | *4,指定的接收者必须为sender_id用户的订阅用户: | ||
**所有接收者都不是订阅用户则报错; | **所有接收者都不是订阅用户则报错; | ||
第78行: | 第70行: | ||
**当指定sender_id用户不是媒体、不是橙V、不是政府时,订阅用户每月只能接收到sender_id用户的一次免费群发; | **当指定sender_id用户不是媒体、不是橙V、不是政府时,订阅用户每月只能接收到sender_id用户的一次免费群发; | ||
+ | |||
+ | 此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务,否则将永久关停指定应用或V用户使用资格。 | ||
==当前支持发送的消息类型(type)中,data支持的参数== | ==当前支持发送的消息类型(type)中,data支持的参数== | ||
− | <h3> | + | <h3>1、纯文本类型私信消息:text</h3> |
<pre> | <pre> | ||
{ | { | ||
第109行: | 第103行: | ||
curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&sender_id=******&receiver_id=******&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/send.json" -k | curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&sender_id=******&receiver_id=******&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/send.json" -k | ||
</pre> | </pre> | ||
+ | |||
+ | |||
+ | <h3>2、图文类型私信消息:articles</h3> | ||
+ | <pre> | ||
+ | { | ||
+ | "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个 | ||
+ | ] | ||
+ | } | ||
+ | </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="4" scope="col" |<span id="data参数支持的参数">data参数支持的参数</span> | ||
+ | |- | ||
+ | |style="text-align:center; width: 12%"|参数名称 | ||
+ | |style="text-align:center;width: 12%"|值的类型 | ||
+ | |style="text-align:center;width: 11%"|是否必填 | ||
+ | |style="text-align:center;"|说明描述 | ||
+ | |- | ||
+ | |articles:display_name | ||
+ | |string | ||
+ | |true | ||
+ | |图文的显示名称标题 | ||
+ | |- | ||
+ | |articles:summary | ||
+ | |string | ||
+ | |true | ||
+ | |图文的文字描述 | ||
+ | |- | ||
+ | |articles:image | ||
+ | |string | ||
+ | |false | ||
+ | |图文的缩略显示图片 | ||
+ | |- | ||
+ | |articles:url | ||
+ | |string | ||
+ | |true | ||
+ | |图文的URL地址,点击后跳转 | ||
+ | |} | ||
+ | |||
+ | |||
==返回结果== | ==返回结果== | ||
<pre> | <pre> | ||
第119行: | 第161行: | ||
{ | { | ||
"request": "/2/messages/post.json", | "request": "/2/messages/post.json", | ||
− | "error_code": | + | "error_code": 264XX, |
"error": "error message." | "error": "error message." | ||
} | } |
2014年2月11日 (二) 14:47的最后版本
私信订阅群发接口
功能: 私信订阅群发接口,V用户可通过此接口给自己的订阅用户群发私信
接口调用地址:https://m.api.weibo.com/2/messages/post.json
HTTP请求方式:POST
是否需要登陆:是
频次限制:是
接口请求参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
source | string | true | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
sender_id | int64 | false | 消息发送方的用户ID,默认不填为当前登录用户ID。 |
range_type | int | true | 群发的范围,0:发送给指定的receiver_ids订阅用户;1:发送给所有订阅用户。默认为0。 |
receiver_ids | string | false | 群发的订阅用户ID,多个时使用英文半角逗号符分隔,最多不超过10000个。仅当range_type参数为0时有效且必填。 |
type | string | true | 需要以何种消息类型发送。text:纯文本,articles:图文 |
data | string | true | 消息数据,具体内容严格遵循type类型对应格式。必须为json做URLEncode后的字符串格式,采用UTF-8编码。 |
注意事项
- 1,当指定的sender_id不是当前登录用户时:
- 当前登录用户必须为当前应用的所有者;
- 2,指定的sender_id用户已指定当前应用为其开发,且指定的sender_id用户已开启“开发模式”;
- 3,当指定sender_id认证用户为媒体类型时,发送失败;
- 4,指定的接收者必须为sender_id用户的订阅用户:
- 所有接收者都不是订阅用户则报错;
- 部分接收者为订阅用户返回成功,仅向订阅用户发送,非订阅用户不发送;
- 5,群发周期内,已接收过免费群发的订阅用户不再接收此免费群发:
- 当指定sender_id用户为橙V、政府时,订阅用户每周只能接收到sender_id用户的一次免费群发;
- 当指定sender_id用户不是媒体、不是橙V、不是政府时,订阅用户每月只能接收到sender_id用户的一次免费群发;
此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务,否则将永久关停指定应用或V用户使用资格。
当前支持发送的消息类型(type)中,data支持的参数
1、纯文本类型私信消息:text
{ "text": "纯文本回复" }
data支持的参数描述 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
text | string | true | 要回复的私信文本内容。文本大小必须小于300个汉字。 |
举例:
当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d
则对应的调用为:
curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&sender_id=******&receiver_id=******&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/send.json" -k
2、图文类型私信消息:articles
{ "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 | 图文的文字描述 |
articles:image | string | false | 图文的缩略显示图片 |
articles:url | string | true | 图文的URL地址,点击后跳转 |
返回结果
// 成功返回 { "result": true //成功返回true,否则报错 } // 失败返回 { "request": "/2/messages/post.json", "error_code": 264XX, "error": "error message." }
文档更新时间: 2014-02-11