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
}

其他