共计 1522 个字符，预计需要花费 4 分钟才能阅读完成。
一封传话聚合推送高级个性 API
前言
上一次介绍了一封传话的 API 文档的次要推送 API，次要用于实现疾速推送到微信、企业微信、钉钉、飞书、邮箱、自定义 Webhook。集成该 API 后仅需 1 个必传参数，即可实现一次推送多端接管和一次推送多人接管性能。
在电脑端，咱们依照官网的创立、测试流程调用的 API 是 send 接口，可能满足绝大多数用户的需要。
在挪动端提供了更丰盛的配置界面，例如预设参数、执行周期抉择、音讯通道缺省配置主动填充，加强原有 API 接口后能够实现更加弱小的 trigger 接口，能够满足局部用户的高级需要。
上面是 tigger 的接口文档和 send 接口文档比拟后发现入参和出参简直没有区别，这里介绍次要 trigger 接口绝对于 send 接口加强后的高级个性：
发送揭示接口
- 申请地址：https://www.phprm.com/service…
- 申请 URL 上的 xxxxxxxxxxxxxxxx, 是您创立揭示的口令码
- 申请形式：GET 倡议对参数进行 urlencode 编码, POST 形式申请头,Content-Type: application/json
| 参数名称 | 是否必填 | 默认值 | 阐明 |
|---|---|---|---|
| head | 否 | 挪动端可预设 | 音讯题目, 长度 200 以内 |
| body | 否 | 挪动端可预设 | 音讯内容, 长度 50000 以内, 反对 markdown 格局, 请参考 markdown 语法 |
| delayMilliseconds | 否 | 0 | 提早推送毫秒数, 不倡议传递, 如需传递最大不超过 45 天 |
| url | 否 | 挪动端可预设 | 不填将应用官网网址进行预览, 填写后将跳转到自定义网址, 例如: https://weibo.com |
GET 申请形式样例：
https://www.phprm.com/services/push/trigger/xxxxxxxxxxxxxxxx?head= 默认题目 &body= 默认内容音讯推送接口响应内容样例：
{
"code": 0,
"message": "申请胜利",
"data": {
"messageIdList": ["1195026147680247809"]
}
}trigger 具备 send 所有个性，减少了前置预处理和后置解决。思考到 trigger 接口执行步骤多会耗费更多的性能，而且会略微减少 API 调用耗时。您能够参考是否应用以下高级个性，再决定应用 send 接口还是 trigger 接口。
高级个性
- 预置题目 head、预置注释 body，无需传递任何参数即可实现推送；
- 预置题目 head、预置注释 body 反对 {{变量}} 实现参数映射, 预设 {{title}} 和{{content}}当前 trigger API 将通过?title= 题目 &content= 注释调用形式；
- 预置题目 head 和预置注释 body 的变量属性层级反对 10 层以内参数映射，例如网页更新揭示的 {{data.title}} 和{{data.text}}属于第 2 层；
- 新增触发形式：口令触发(send 接口也反对)、定时触发(quartz 表达式或者按年月日循环执行)；
- 新增触发一次个性, 容许执行一次推送后主动暂停揭示状态；
能够这么了解，send 接口是一个高性能音讯推送接口，trigger 做一层包装后性能更弱小。
特地是通过预置 {{参数}} 映射其余开源软件参数, 如果您的路由器或者某些软件的 webhook 参数无奈批改，能够试试 trigger。实践上绝大多数的软件的 webhook 都能适配，目前已适配 Granfna 告警、网页更新揭示、Server 酱、Gitee、Github，欢送到挪动端体验。
如果您没有用到以上高级个性能够间接应用 send 接口，这样 http 申请提早会更小一些。
参考：
一行代码实现微信音讯推送
一封传话推送工具 API 文档
http://push.phprm.com/api.html
