微信模板消息通知

最近更新时间: 2023年12月25日 02时58分42秒

能力接口

描述

该接口为微信模板消息推送接口，具体送达情况请根据返回的消息 ID 查询，用户在进入同济大学移动门户后，需要点击”我的”进行授权同意及统一身份认证登录，并且关注同济信息化微信公众号，才能在同济信息化微信公众号接收业务微信消息，授权页面如下图

注意事项

https://mp.weixin.qq.com/s/hvLO4Vs75NXDA__SxuyKXw

2023 年 5 月 4 日规范公众号模板消息

1）去除自定义颜色、表情符号；（表情符号由替换为“□”改为直接去除）

2）去除尾部/备注内容；

3）去除首行内容；单个中间主内容不超过 20 字，且不支持换行。

支持的模式

客户端模式

请求方法

POST

请求地址

https://api.tongji.edu.cn/v1/infra/notification/mp

数据来源

请求体参数

参数名	类型	是否必须
userId	STRING	是
type	STRING	是
url	STRING	否
data	OBJECT	是
time	UNIX	否

返回参数

参数名	类型	备注	码表
ucsId	STRING	消息推送 ID，请自行保存,可根据该 ID 查询具体推送结果

解释说明

TDL 待办事项(to do list)
EN 考试通知(Examination notice)
JML 作业消息提醒(Job message reminder)
WR 工作提醒(Work reminder)
JDS 作业即将到期(Job due soon)
FWR 故障警告提醒(Fault warning reminder)
MDAN 监控设备报警通知(Monitoring device alarm notification)
AR 审批提醒(Approval reminder)
OPPAN 网上流程待审批通知(Online process pending approval notice)
TDL 待办事项请求示例


curl -X 'POST' \
  'https://api.tongji.edu.cn/v1/infra/notification/mp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer e447e4b4b8e23973b42c44b8d324242' \
  -d '{
  "userId": "20****93",
  "type": "TDL",
  "url": "https://baidu.com",
  "data": {
    "header": "这是标题头",
    "type": "这里填待办类型",
    "list": "这里填待办事项",
    "step": "这里填待办步骤",
    "content": "这里填待办内容",
    "remark": "备注"
  },
  "time": "1661221947"
}'

EN 考试通知请求示例


curl -X 'POST' \
  'https://api.tongji.edu.cn/v1/infra/notification/mp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer e447e4b4b8e23973b42c44b8d324242' \
  -d '{
  "userId": "20****93",
  "type": "EN",
  "data": {
    "header": "这是标题头",
    "name": "这里填考试名称",
    "class": "这里填班级",
    "time": "这里填考试时间",
    "remark": "备注"
  }
}'

JML 作业消息提醒请求示例


curl -X 'POST' \
  'https://api.tongji.edu.cn/v1/infra/notification/mp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer e447e4b4b8e23973b42c44b8d324242' \
  -d '{
  "userId": "20****93",
  "type": "JML",
  "data": {
    "header": "这是标题头",
    "class": "这里填所属班级",
    "info": "这里填作业提醒",
    "remark": "备注"
  }
}'

WR 工作提醒请求示例


curl -X 'POST' \
  'https://api.tongji.edu.cn/v1/infra/notification/mp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer e447e4b4b8e23973b42c44b8d324242' \
  -d '{
  "userId": "20****93",
  "type": "WR",
  "data": {
    "header": "这是标题头",
    "title": "这里填标题",
    "date": "这里填日期",
    "content": "这里填内容",
    "remark": "备注"
  }
}'

请求示例


curl -X POST \
  'https://api.tongji.edu.cn/v1/infra/notification/mp' \
  -H 'Content-Type: application/json' \
  -d '{
  "userId": "",
  "type": "",
  "url": "",
  "data": {},
  "time": 1748593942
}'

返回示例


{
  "data": {
    "ucsId": "1897"
  },
  "code": "A00000",
  "msg": "success",
  "time": "2023-06-04 13:34:29.758"
}