# 发送通知
通过主体的发卡公众号向指定的用户(可批量)发送通知。
# 1.申请方式
发送邮件到seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com , lindayyang@tencent.com , ronniewan@tencent.com),申请时需要注明应用APPKEY、应用名称、及应用使用场景
# 2.接口地址
# 请求方法:
POST(application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/notice/send?access_token=access_token
注:若私有化部署,接口地址域名变更私有化域名
# 3.请求参数
{
"cards": "CARDS",
"title": "TITLE",
"content": "CONTENT",
"sender": "SENDER",
"digest":"DIGEST",
"customs":"CUSTOMS"
}
参数 | 必填 | 示例值 | 类型 | 说明 |
---|---|---|---|---|
access_token | 是 | k3yCoY5VYHWyVhgUPud2mtfOFvRvossc | String | 授权有效凭证 (opens new window) |
cards | 是 | ["111111111","222222222","333333333"] | String | 学号数组,转成Json |
title | 是 | 全体代表大会 | String(100) | 通知标题 |
content | 是 | 请大家务必参加 | String(1000) | 通知内容 |
sender | 是 | 教务处 | String(60) | 通知人 |
digest | 否 | 请大家务必参加 | String(100) | 通知摘要,如不传会自动截取通知内容文案 |
customs | 否 | ["You have a notice to check","https://weixiao.qq.com"] | String | 自定义参数,分别为提示文案和通知跳转链接,如不传则公众号模版消息会默认显示'你有一条通知待查看',并跳转到微校通知详情页 |
# 4.返回数据
# 响应说明:
{
"code": 0,
"message":"ok",
"mark":"***"
}
参数 | 是否可空 | 说明 |
---|---|---|
code | 非空 | 返回码(0表示成功) |
message | 非空 | 提示信息 |
mark | 可空 | 通知标识,可通过此值调接口查询该通知的数据明细和已读情况 |
# 5.错误码
名称 | 解决方案 |
---|---|
1003 | 没有权限(请联系微校工作人员开通该权限) |
1005 | 参数缺失(请核对参数cards) |
1015 | 网络错误(请重试) |
47001 | 学校标识码不合法(请核对参数school_code) |
# 注意事项
1.私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)