发送提醒API

提示

本文将讲解如何快速使用一封传话的发送提醒API

# 提醒接口API文档

请求地址：https://www.phprm.com/services/push/trigger/xxxxxxxxxxxxxxxx
请求URL上的xxxxxxxxxxxxxxxx, 是您创建提醒的口令码
请求方式：GET建议对参数进行urlencode编码, POST方式请求头,Content-Type: application/json

参数名称	是否必填	默认值	说明
head	否	移动端可预设	消息标题, 长度200以内
body	否	移动端可预设	消息内容, 长度50000以内, 支持markdown格式, 请参考markdown语法
delayMilliseconds	否	0	延迟推送毫秒数, 不建议传递, 如需传递最大不超过15天
url	否	移动端可预设	不填将使用官方网址进行消息阅读, 填写后将跳转到自定义网址, 例如: https://weibo.com

GET请求方式样例：

https://www.phprm.com/services/push/trigger/xxxxxxxxxxxxxxxx?head=默认标题&body=默认内容

消息推送接口响应内容样例：

{
	"code": 0,
	"message": "请求成功",
	"data": {
		"messageIdList": [
			"1195026147680247809"
		]
	}
}

1
2
3
4
5
6
7
8
9

# 提醒接口高级特性

预置标题head、预置正文body，无需传递任何参数即可完成推送；
新增触发方式：口令触发(send接口也支持)、定时触发(quartz表达式或者按年月日循环执行)；
新增触发一次特性, 允许执行一次推送后自动暂停提醒状态；
支持关键词屏蔽和关键词匹配, 可以过滤含有某些关键词的推送或者只接受含有某些关键词的推送；

例如，上图设置屏蔽关键词：积分,新用户时，所有消息带有"积分"或者"新用户"等关键词时，将无法收到推送；或者设置匹配关键词：立减,秒杀，那么仅当消息带有"立减"或者"秒杀"时才能接收到推送。

屏蔽词推荐（1）为什么,怎么,请问,是不是,出个,谁要,可以不,好点,什么,怎么,有没

屏蔽词推荐(2) 老哥,兄弟们,怎么办,求助

匹配词推荐（1） e卡,eka,猫卡,话费,红包,立减金,现金,支付金,云闪付,翼支付,京豆,实物,快递,免费,会员,q币,必中,新用户,老用户,快去,秒到,美团,百度,京东,淘宝,天猫,app,速度,下载,登陆,登录,秒杀,建行,工行,农行,邮储,南京,宁波,兴业,中行,光大,华夏,浦发,厦门,中信,平安,招商,民生,交通,买单吧,喜大浦奔,动卡,华彩,阳光惠生活,全民,掌上,缤纷,建行生活,cc豆,银行,zfb,支付宝,自测,亲测,还有,放水,福利,神价,冲好价,撸神券,bug,抽奖,元,刚中,小包,tb,jd,实测,无门槛,和包,支付,抓紧,电费,首发,还可以,白得,补货,赶紧,好用,加果,优惠券

匹配词推荐（2）首发,冲,有水,大水,速度,大毛,神价,手慢无,水了,bug,撸,好价,红包,话费,电费,白条,ysf,yzf,立减金,顺丰,河南,0371,储蓄卡,无门槛,必中,毛。

匹配词推荐（3）八喜,冰淇淋,冰,饮料,空刻,哈根达斯,神,意面,零食,老朋友,光明,鲜奶,车回,大桶,囤,理肤泉,面膜,建行生活,建行,交行,招商,猫超

匹配词推荐（4）大毛,速度,速撸,大水,有水,BUG,bug,首发,立减金,手慢无,攻略,作业,建行,工行,广发,平安,招行,掌上生活,瑞幸,工银,农药,王者,xing/用卡,信用卡,还款,红包,腾讯云,数字人民币,iphone,苹果,小米,活期,微众,秒到,吧码,笔记本,xyk,温州,买单吧,交通银行,交行,最红星期五,陆金所,话费

匹配词推荐（5） BUG,漏洞,神价,大毛,速度

匹配词推荐（6）洗衣液,洗衣凝珠,豪车,神价,大米,罐头,猫粮,收纳,bug,免费,女装,食用油,抽纸,卫生纸,卷纸,膨润土,喵洁客,百利,冻干,永璞,高蛋白,渴望,咖啡,化妆品,烤箱,一号店,三能,烘焙,鸡腿,小龙虾,黄金,扫地机器人,湿厕纸,粘毛卷纸,美皮护,厨房纸,牛肉,洗面奶

匹配词推荐（7）神券,0371,招商,中信,河南,浦发,一元,光大,邮储,中行,农行,广发,e卡,E卡,建行,工行,平安,网上国网

匹配词推荐（8）酸奶,蒙牛,面纸,洗衣液,立白,心相印,零食,唇釉

匹配词推荐（10）数字潮人,建行,工行,农行,邮储,南京,宁波,兴业,中行,光大,华夏,浦发,厦门,中信,平安,招商,民生,交通,买单吧,喜大浦奔,动卡,华彩,阳光惠生活,全民,掌上,缤纷,建行生活,cc豆,e卡,翼支付,银行,zfb,支付宝

匹配词推荐（11）神券,0371,招商,中信,河南,浦发,一元,光大,邮储,中行,农行,广发,e卡,E卡,建行,工行,南京银行,平安,民生,华夏,网上国网,华为视频

匹配词推荐（12）冲锋衣,登山鞋,徒步鞋,登山包,户外,运动,立减金,冲锋裤,徒步包,登山背包,徒步背包,登山杖,睡袋,凯乐石,哥伦比亚,迈乐,狼爪,耐克,nike,萨洛蒙,salomon,黑冰

匹配词推荐（13）化妆刷,一滴泪,粉底,气垫,挂烫机,熨烫机,充电宝,移动电源,intoyou,柏瑞美,唇泥,colorkey,珂拉琪,墨镜,镜,松下,吹风机

匹配词推荐（14）湖南,鞋,立减金,猫超卡,拼夕夕,外卖,美团,直播间,百亿补贴,工行,建行,农行,中国银行,蜜雪冰城,电器,空调,麦片,蛋白粉,牛奶,酸奶,短袖,电费,话费,会员,内裤,袜子,美宜佳,麦当劳,肯德基,华莱士,福仔,省钱卡,移动,联通,电信,小程序,公众号,康师傅,支付宝,微信

匹配词推荐（15）湿纸巾,湿巾,skii,神仙水,乐高,椰子水,山姆,鸡胸,鸡,文具,书,笔,派通,驱蚊水,面霜,海蓝之谜,黑绷带,金,图书,耳钉,首饰,耳环,电饭煲,电饭锅,水,纯净水,怡宝,农夫山泉,榴莲,牛油果,沐浴露,粽子,兰蔻,coach,钱包,三得利,黄金,修丽可,口红,完美日记,colorkey,唇膏,ysl,圣罗兰,气垫,包包,粉,粉底,阿玛尼,雅诗兰黛,小黑瓶,小棕瓶,巴黎世家,BV,葆蝶家,驱蚊,膏药,乌龙茶,茶,燕麦奶,晴王,阳光玫瑰,cdf,CDF,中免,海免,日上,电解质,外星人,西梅,水果

匹配词推荐（16）建行,建设银行,浦发,信用卡,xing/用卡,广发,光大,民生,平安,交通,大水,大毛,美素佳儿,威士露,洗衣粉,护垫,卷纸,卫生纸,湿巾,肚脐贴,洗脸盆,电费,打印机。

匹配词推荐（17）戴森,母婴,湿厕纸,血压,DHA,可悠然,吹风机,耳温枪,机油,水牛奶,漱口水,养元青,火腿,可心柔,hegen,赫根

trigger具备send所有特性，增加了前置预处理和后置处理。考虑到trigger接口执行步骤多会消耗更多的性能，而且会稍微增加API调用耗时。您可以参考是否使用以下高级特性，再决定使用send接口还是trigger接口。

可以这么理解，send接口是一个高性能消息推送接口，trigger做一层包装后功能更强大。

特别是通过预置映射其他开源软件参数, 如果您的路由器或者某些软件的webhook参数无法修改，可以试试trigger。理论上绝大多数的软件的webhook都能适配，目前已适配Granfna告警、网页更新提醒、Server酱、Gitee、Github，欢迎到移动端体验。

如果您没有用到以上高级特性可以直接使用send接口，这样http请求延迟会更小一些。