Notice/app/send
(创建新页面为 '{{api_desc2| uri=notice/app/send| desc=给指定的一个或多个用户发送一条新的或已有的第三方应用通知| format=XML/JSON| httpMethod=POST| needAuth=true| rat…') |
|||
| 第2行： | 第2行： | ||
uri=notice/app/send| | uri=notice/app/send| | ||
desc=给指定的一个或多个用户发送一条新的或已有的第三方应用通知| | desc=给指定的一个或多个用户发送一条新的或已有的第三方应用通知| | ||
| − | format= | + | format=JSON| |
httpMethod=POST| | httpMethod=POST| | ||
needAuth=true| | needAuth=true| | ||
2011年5月26日 (四) 18:30的版本
目录 |
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. 通过审核的应用：
- 通知只能发送给该应用的授权用户和应用创建者自己；
- 普通应用：1000条/天/应用
- 高级应用：5000条/天/应用
- 4. 连续两条通知内容不能重复；
- 5. 新发通知用title、content参数，发送已有通知用notice_id参数。
返回结果
XML示例
<notice_id>12035</notice_id>
JSON示例
{
"notice_id": 12035
}
其他
无
