第37行: | 第37行: | ||
resultDes=无| | resultDes=无| | ||
useAge= | useAge= | ||
− | * | + | *发布通知调用接口的登录帐号必须为该appkey的创建者,因此需要使用创建者帐号通过Base Auth的方式调用; |
*连续两条通知内容不能重复; | *连续两条通知内容不能重复; | ||
*第三方状态通知只能发送给该应用的授权用户和应用创建者自己; | *第三方状态通知只能发送给该应用的授权用户和应用创建者自己; |
2012年6月8日 (五) 14:05的版本
notification/send
给一个或多个用户发送一条新的状态通知
URL
https://api.weibo.com/2/notification/send.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
uids | true | string | 接收通知的用户UID,支持1-100个用户,用逗号分隔。 |
tpl_id | true | int | 发送通知所对应的模版ID,必须是通过审核,且启用中的模版。 |
objects1 | false | string | 通知的自定义变量1,可以是人也可以是系统实物,支持@用户昵称,最多不超过32个字节。 |
objects1_count | false | int | 通知的自定义变量1的数量,正整数,最多不超过2个字节,支持0-99。 |
objects2 | false | string | 通知的自定义变量2,可以是人也可以是系统实物,支持@用户昵称,最多不超过32个字节。 |
objects2_count | false | int | 通知的自定义变量2的数量,正整数,最多不超过2个字节,支持0-99。 |
objects3 | false | string | 通知的自定义变量3,可以是人也可以是系统实物,支持@用户昵称,最多不超过32个字节。 |
objects3_count | false | int | 通知的自定义变量3的数量,正整数,最多不超过2个字节,支持0-99。 |
action_url | false | string | 通知的处理链接,支持短链接,最多不超过20个字节。 |
注意事项
- 发布通知调用接口的登录帐号必须为该appkey的创建者,因此需要使用创建者帐号通过Base Auth的方式调用;
- 连续两条通知内容不能重复;
- 第三方状态通知只能发送给该应用的授权用户和应用创建者自己;
- 未通过审核、和未启用的通知模版,只能发送给开发者自己;
- 模版状态必须是通过审核的,且是启用状态,否则通知不能发出,返回错误信息;
- 状态通知是可以合并,合并规则如下:
- 同一应用发给同一个人,相同模版的且处于未读状态的通知,会合并;
- objects1参数位置,用“、”连接合并,超过2个后面打“...”省略;
- objects1_count参数位置,数值相加合并,超过99显示99+;
- objects2参数位置,用“、”连接合并,超过2个后面打“...”省略;
- objects2_count参数位置,数值相加合并,超过99显示99+;
- objects3参数位置,用“、”连接合并,超过2个后面打“...”省略;
- objects3_count参数位置,数值相加合并,超过99显示99+;
- action_url参数位置,有新值的话取最新的值,覆盖之前的值来合并;
- 通知部分发送失败,发送失败的用户UID返回在"failed_uid"字段内;
- 通知全部发送失败,返回错误信息;
调用样例及调试工具
返回结果
JSON示例
{ "notification": { "notification_id": 12035, "title": "test", "content": "test", "created_at": "Wed Jan 06 11:26:01+0800 2010", "sender_app": { "appkey62": "4Gcqmc" }, "sender_uid": 1658122963 }, "failed_uid": [ "21485798475", ... ] }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
- 通知模版,内容部分可以使用自定义内容的参数;
- 通知内容模版:固定文案(<350字符)+参数长度上限(<250字符)<300个汉字(600字符);
- 通知模版自定义内容的参数,共支持7个,即可以有7处自定义内容(详见上面的参数说明);
- 通知模版自定义内容的参数,在设置模版时以JSON对象方式表现(详见下面的示例);
申请状态通知时,创建通知模版:
你加入微群:{objects1}的申请,已经被管理员{objects2}通过了,快去群里看看吧{action_url}。
发送状态通知时,传入参数实际值:
?objects1=微家园&objects2=@家园小秘书&action_url=http://t.cn/Shb44L
则实际收到的通知为:
你加入微群:微家园的申请,已经被管理员@家园小秘书通过了,快去群里看看吧http://t.cn/Shb44L。
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问