# 发送通知

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

# 1.申请方式

需发送应用名称、应用APPKEY和使用场景到zhimuli@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) 主体标识码,查看主体代码
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)