# 发送通知

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

# 1.申请方式

需发送应用名称、应用APPKEY和使用场景到johanzheng@tencent.com进行申请(邮件同时也抄送至hongfuhuang@tencent.com，ronniewan@tencent.com，marshalyang@tencent.com)

# 2.接口地址

# 请求方法：

POST(application/json)

# 请求地址：

https://uni.weixiao.qq.com/open/notice/send

注：若私有化部署，接口地址域名变更私有化域名

注意：本地部署的主体不能使用上面接口地址，需要根据主体本地域名拼上对应的路径，例如主体域名是https://XXXX.com，那么这里调用的接口地址应该是https://XXXX.com/open/notice/send

# 3.请求参数

{
    "school_code": "SCHOOL_CODE",
    "cards": "CARDS",
    "title": "TITLE",
    "content": "CONTENT",
    "sender": "SENDER",
    "app_key": "APP_KEY",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "signature": "SINGATURE",
    "digest":"DIGEST",
    "customs":"CUSTOMS",
}

参数	必填	示例值	类型	说明
school_code	是	4111010001	int(10)	主体标识码，查看主体代码 (opens new window)
cards	是	[\"111111111\",\"222222222\",\"333333333\"]	Json	电子卡号数组，转成Json
title	是	全体代表大会	String	通知标题
content	是	请大家务必参加	String	通知内容
sender	是	教务处	String	通知人
app_key	是	CA1D905AC89ACDCA	String(16)	腾讯微卡分配
timestamp	是	1514276659	int	当前unix时间戳
nonce	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串
signature	是	A790E009D30C09BD8605810EAF9C44B0	String(32)	按照签名算法生成的签名
digest	否	请大家务必参加	String(32)	通知摘要，如不传会自动截取通知内容文案
customs	否	[\"You have a notice to check\",\"https://weixiao.qq.com\"]	Json	自定义参数，需转成Json，分别为提示文案和通知跳转链接，如不传则公众号模版消息会默认显示'你有一条通知待查看'，并跳转到腾讯微卡通知详情页返回数据

# 4.返回数据

# 响应说明：

{
    "code": 0,
    "message":'ok',
    "mark":'***'
}

参数	是否可空	说明
code	非空	返回码（0表示成功）
errmsg	非空	提示信息
mark	可空	通知标识,可通过此值调接口查询该通知的数据明细和已读情况

# 错误返回：

{
    "code": xxx,(非0错误码)
    "message": xxx,(错误信息)
}

# 5.错误码

名称	解决方案
1003	没有权限（请联系腾讯微卡工作人员开通该权限）
1004	参数错误（请核对参数cards）
1015	网络错误（请重试）
1023	签名校验失败（请参考全局需知—签名算法）
47001	主体标识码不合法（请核对参数school_code）