参数 | 描述 | 必填 |
---|---|---|
push_key | 接口密钥;在app上获取,使用temp_key时则不填 | 是 |
title | 消息标题;title和content至少填一项 | 是 |
content | 消息内容;title和content至少填一项 | 是 |
date | 消息时间;格式为"YYY-mm-dd HH:ii:ss",默认为当前日期时间 | 否 |
type | 消息类型;默认为"text" | 否 |
temp_key | 临时密钥new;在app上获取 | 否 |
提示:所有参数值类型都为string字符串
类型 | 属性 | 描述 | 示例(content) |
---|---|---|---|
text | 通知消息 | 普通文本消息 | hello world ! |
markdown | 通知消息 | markdown格式文本消息 | ## hello world ! |
html | 通知消息 | html格式消息 | <div style="border: 10px solid #46bc99; text-align: center; font-size: 30px;">HTML</div> |
data | 数据消息 | 普通数据消息,建议写一个纯数字 | 999 |
markdata | 数据消息 | markdown格式数据消息 | > 在线人数:100\n> 新用户数:10 |
chart | 数据消息 | 图表消息,格式见下面说明 | 999 |
echarts | 数据消息 | echarts图表 | {"series":[{"type":"pie","data":[{"value":81,"name":"A"},{"value":55,"name":"B"},{"value":49,"name":"C"}]}]} |
提示:html和echarts消息使用webview渲染,性能会差一点。如非特殊需要,建议使用其他消息类型。
- 数据消息以title作为唯一标识,同一标识只显示一个模块,内容为最后推送的内容
- markdown消息内链接支持APP内打开,需要在设置里开启
- html消息支持css样式,支持运行js,运行js需要在设置里开启
- html消息如果不含body标签,系统会自动添加body标签,并添加一些基础样式,安卓端会自动适配暗黑模式
- html消息如果包含body标签,系统不做处理
- 在电脑端body标签不支持设置attribute属性,不支持html标签
- echarts消息内容为echarts图表的option参数的json字符串
- chart消息,格式:类型|长度::value|label,value|label...
- 类型支持bar、line、pie三种,默认值为bar
- 长度代表在客户端保留的数据个数,默认长度为10;如果数据只有value没有label,则遵循先进先出原则,有label并且客户端已有同label数据,则会替换对应值
- value支持整型或float类型
- label,数据的标签或者名字或者key,也支持emoji字符,也可省略
- | , :: 三个字符为分割符,属特殊字符,如果左右有一边为空,请省略分隔符
- 示例1:999,表示bar类型、长度10,数据999
- 示例2:5::888,表示bar类型、长度5,数据888
- 示例3:line|5::888,999,表示line类型、长度5,包含两个数据888和999
- 示例4:pie|5::888|A,999|B,表示pie类型、长度5,包含两个数据888和999,对应标签为A和B
主题 | 标识 | 描述 | 示例(title) |
---|---|---|---|
info | [i] | ⬜️信息 | [i]收到一条信息 |
success | [s] | 🟩成功 | [s]任务执行成功 |
warning | [w] | 🟨警告 | [w]服务器cpu告警 |
failure | [f] | 🟥失败 | [f]网站签到失败 |
提示:消息主题功能没有新增字段,而是在消息title前面添加主题标识符实现。
消息通道(channel),和消息主题一样,没有新增字段,而是在title末尾添加标识符实现,格式为英文中括号+波浪符+通道名字:`[~xxxxx]`,通道名字支持中文。
注意:至少发送一条通道消息后,在手机通知设置里才能看到对应通道,这时,针对不同的通道,可以设置不同的声音、震动、灯光、桌面显示等不同的提示方式。
默认消息通道为MainChannel,默认状态通道为StateChannel,状态通道建议打开显示,方便查看服务连接状态,如不想查看,可以在PushMe左上角设置里关闭,也可以设置为异常时显示。
返回值 | 描述 |
---|---|
success | 发送成功 |
非"success"字符串 | 发送失败的原因 |
json字符串 | 兼容企微/钉钉/飞书接口模式时,返回对应json结果 |