一封传话聚合推送高级个性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