跳转到: 导航, 搜索

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的方式调用;
  • Base Auth调用举例:
curl -u "user:password" -d "source=*****&uids=*****&tpl_id=*****&objects1=微家园&objects2=@家园小秘书&action_url=http://t.cn/Shb44L" "https://api.weibo.com/2/notification/send.json" -k


  • 连续两条通知内容不能重复;
  • 第三方状态通知只能发送给该应用的授权用户和应用创建者自己;
  • 未通过审核、和未启用的通知模版,只能发送给开发者自己;
  • 模版状态必须是通过审核的,且是启用状态,否则通知不能发出,返回错误信息;
  • 状态通知是可以合并,合并规则如下:
    • 同一应用发给同一个人,相同模版的且处于未读状态的通知,会合并;
    • objects1参数位置,用“、”连接合并,超过2个后面打“...”省略;
    • objects1_count参数位置,数值相加合并,超过99显示99+;
    • objects2参数位置,用“、”连接合并,超过2个后面打“...”省略;
    • objects2_count参数位置,数值相加合并,超过99显示99+;
    • objects3参数位置,用“、”连接合并,超过2个后面打“...”省略;
    • objects3_count参数位置,数值相加合并,超过99显示99+;
    • action_url参数位置,有新值的话取最新的值,覆盖之前的值来合并;
  • 通知部分发送失败,发送失败的用户UID返回在"failed_uid"字段内;
  • 通知全部发送失败,返回错误信息;

调用样例及调试工具

API测试工具

返回结果

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。

相关问题


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2014-06-24
api评价