一封传话聚合推送高级特性API

一封传话聚合推送高级特性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语法
delayMilliseconds0延迟推送毫秒数, 不建议传递, 如需传递最大不超过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


专注于消息推送领域,提供极简API,一行代码即可帮您迅速完成消息的推送。

9 声望
3 粉丝
0 条评论
推荐阅读
一封传话一对多推送实现步骤
但是我们希望实现:1. 群组订阅功能:例如我和我的好友一起加入通道后,只推送一次我们两个人都能收到消息。2. 多端提醒功能:例如我希望同时推送到微信和钉钉,如果还能推送到飞书更好了。

一封传话3阅读 509

钉钉企业机器人接入chatgpt进行问答
需求使用chatgpt用于企业内部的问答查询,纯粹是娱乐,因为它太会编了.步骤1. 获取openai的secret2. 选择适当的模型尝试下来, 对话比较适合使用引擎模式;[链接]3. 创建钉钉机器人按文档操作[链接]4. 编写机器人代码...

jacky chen阅读 871

【紧急】微信存在图片闪退漏洞
已经很久没在社区发帖了,考虑到今晚很多普通用户,当然也有程序员朋友中招,因此简单聊聊。因为是技术社区,没有正式安全报告那么严谨,因此排版简单,字数不多,希望你能看懂。

瞿小凯阅读 791

封面图
Unity 2022 + Android 接入微信登录
实现Unity接入安卓端的微信登录分为五个大步骤生成keystore安卓应用开发者签名在微信开放平台申请移动应用接入编写Java Android部分代码, 生成arr文件编写 Unity C# 代码Unity打apk包, 安装到手机中进行测试建议...

镇远阅读 374

极光笔记 | 让运营“从心”出发,打造身临其境的客户体验!
在数字化时代,用户对于个性化、实时和多元化的互动体验需求越来越高。作为中国领先的客户互动和营销科技服务商,极光一直致力于满足客户不断变化的需求。现在,我们很高兴宣布,极光推送富媒体功能全新改造升级...

极光JIGUANG阅读 350

封面图
演示视频:Jira企业微信插件邀您一起迈入移动办公时代,高效处理Jira Issue
在当今快节奏的商务环境中,移动端办公已经成为现代企业管理和团队协作的不可忽视的趋势。现代职场注重灵活性、高效性和便捷性,员工在手机或平板上处理工作事务已经成为日常工作的一部分。

龙智DevSecOps阅读 199

揭秘百度IM消息中台的全量用户消息推送技术改造实践
百度的IM消息中台为百度APP以及厂内百度系产品提供即时通讯的能力,提供包括私聊、群聊、聊天室、直播弹幕等用户沟通场景,并帮助业务通过消息推送触达用户。如今,百度APP新增了一种需要以“低用户打扰”的形式触...

JackJiang阅读 176

封面图

专注于消息推送领域,提供极简API,一行代码即可帮您迅速完成消息的推送。

9 声望
3 粉丝
宣传栏