一封传话推送工具API文档
前言
【一封传话】是一款聚合推送工具,提供微信公众号、飞书、钉钉、企业微信群机器人、企微通知应用、邮件、自定义Webhook消息推送API。主要API只有一个,必传参数也只有一个,因此没有使用门槛,如果不想去查询是否推送成功,只看消息推送接口即可。
消息推送接口
-
请求地址:https://www.phprm.com/services/push/send/xxxxxxxxxxxxxxxx
-
请求URL上的xxxxxxxxxxxxxxxx, 是您创建消息通道的通道码
-
请求方式:GET建议对参数进行urlencode编码, POST方式请求头,Content-Type: application/json
GET请求方式样例:
消息推送接口响应内容样例:
参数说明
仅head参数必传,长度200个字符长度以内。
如果有延迟推送的需求,可以试试delayMilliseconds,如果有按年月日周期推送的需求,可以查看移动端官网。
如果您传递了url参数可以使用您个人博客或者公司网页进行预览消息,也可以使用markdown语法在body参数中嵌入网址。
body参数支持Markdown语法和emoji表情,移动端渲染效果很棒,例如公告类型消息的markdown模板如下:
代码参考
实际上只有一行代码, 只是为了渲染出如下效果(手机端体验最佳)才使用Markdown字符串作为body的参数:
Tips:传递url参数将自动跳转您个人/公司的网页,未传递url参数时【一封传话】将为您渲染Markdown图文预览页面。
在线调试与日志
Tips:官网首页支持在线测试,无需编写任何代码即可推送到微信上。
消息查询接口
-
请求地址:https://www.phprm.com/services/push/sendMessageResult/xxxxxxxxxxxxxxxx
-
请求URL上的xxxxxxxxxxxxxxxx, 是您创建消息通道的通道码
-
请求方式:?messageIds=1205957302260228096。如果有多个消息ID请使用英文,分隔传参。
GET请求方式样例:
消息查询接口响应内容样例:
在线查询消息推送情况
Tips:官网首页点击发送按钮后会自动填充到查询参数框,如果是从日志页面复制的消息ID也可以到这里查询。
尾声
【一封传话】是一个集成了微信、企业微信、钉钉、飞书、邮件、webhook等聚合消息推送平台。只需要调用简单的API,即可帮您迅速完成消息的推送。
当您采集别人网站的公告然后推送到自己的手机上,及时关注您想要知道的信息,手机端管理非常方便。
参考:
http://push.phprm.com/
http://push.phprm.com/doc/#/p/send
http://push.phprm.com/doc/#/p/demo
https://www.phprm.com/push/h5/