# 发送通知

通过主体的发卡公众号向指定的用户(可批量)发送通知。

# 1.申请方式

发送邮件到zhimuli@tencent.com进行申请(邮件同时也抄送至hongfuhuang@tencent.com,ronniewan@tencent.com,marshalyang@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)