Notice/app/send
目录 |
notice/app/send
给指定的一个或多个用户发送一条新的或已有的第三方应用通知
URL
http://api.t.sina.com.cn/notice/app/send.(json%7Cxml)
支持格式
JSON
HTTP请求方式
POST
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
uids | true | string | 接收通知的用户uid,支持1-100个用户,用逗号分隔. |
title | true | string | 通知标题,必填,<30个汉字.必须做URLEncode,采用UTF-8编码。 |
content | true | string | 通知内容,必填,<300个汉字.必须做URLEncode,采用UTF-8编码。 |
notice_id | true | string | 通知ID,必填,该参数与title、content参数互斥并优先,当传了notice_id参数,将忽略title、content参数,notice_id参数必须是该应用发出过的。 |
注意事项
- 1. 发布通知的登录帐号必须为该appkey的创建者;
- 2. 未通过审核的开发中应用:
- 测试通知只能发送给测试账号和应用创建者自己;
- 20条/天/应用;
- 3. 通过审核的应用:
- 通知只能发送给该应用的授权用户和应用创建者自己;
- 每天发送条数上限:
- 该应用昨日活跃用户数(如昨日活跃用户数小于500,则上限为500);
- 一个用户一天只能接收一个应用的通知,不能超过1条;
- 4. 连续两条通知内容不能重复;
- 5. 新发通知用title、content参数,发送已有通知用notice_id参数。
- 6. 此接口需要申请,通过后才能使用。
返回结果
XML示例
<notice_id>12035</notice_id>
JSON示例
{ "notice_id": 12035 }
其他
无