乐趣区

关于消息推送:一封传话聚合推送高级特性API

jiezi

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

高级个性

  1. 预置题目 head、预置注释 body，无需传递任何参数即可实现推送；
  2. 预置题目 head、预置注释 body 反对 {{变量}} 实现参数映射, 预设 {{title}} 和{{content}}当前 trigger API 将通过?title= 题目 &content= 注释调用形式；
  3. 预置题目 head 和预置注释 body 的变量属性层级反对 10 层以内参数映射，例如网页更新揭示的 {{data.title}} 和{{data.text}}属于第 2 层；
  4. 新增触发形式：口令触发(send 接口也反对)、定时触发(quartz 表达式或者按年月日循环执行)；
  5. 新增触发一次个性, 容许执行一次推送后主动暂停揭示状态；

能够这么了解，send 接口是一个高性能音讯推送接口，trigger 做一层包装后性能更弱小。

特地是通过预置 {{参数}} 映射其余开源软件参数, 如果您的路由器或者某些软件的 webhook 参数无奈批改，能够试试 trigger。实践上绝大多数的软件的 webhook 都能适配，目前已适配 Granfna 告警、网页更新揭示、Server 酱、Gitee、Github，欢送到挪动端体验。

如果您没有用到以上高级个性能够间接应用 send 接口，这样 http 申请提早会更小一些。

参考：

一行代码实现微信音讯推送

一封传话推送工具 API 文档

http://push.phprm.com/api.html

退出移动版