微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
*此接口即将面向所有机构认证帐号(蓝V) 开放,为确保功能及服务的完善,当前为小范围内测阶段。将于11月下旬左右全面开放,届时开启粉丝服务开发模式的V用户皆可使用。 =私信订阅群发接口= 功能: 私信订阅群发接口,蓝V可通过此接口给自己的订阅用户群发私信 接口调用地址:https://api.weibo.com/2/messages/post.json HTTP请求方式:POST 是否需要登陆:是 频次限制:是 <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="接口请求参数">接口请求参数</span> |- |style="text-align:center; width: 12%"|参数名称 |style="text-align:center;width: 12%"|值的类型 |style="text-align:center;width: 11%"|是否必填 |style="text-align:center;"|说明描述 |- |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:纯文本 |- |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支持的参数== <h3>纯文本类型私信消息:text</h3> <pre> { "text": "纯文本回复" } </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;"|说明描述 |- |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 则对应的调用为: <pre> 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> // 成功返回 { "result": true //成功返回true,否则报错 } // 失败返回 { "request": "/2/messages/post.json", "error_code": "264XX", "error": "error message." } </pre> __NOTOC__
返回到
2/messages/post
。
反馈
分享
顶部