一封传话聚合推送API文档-优快云博客

一封传话聚合推送API文档

前言

【一封传话】是一款聚合推送工具，提供微信公众号、飞书、钉钉、企业微信群机器人、企微通知应用、邮件、自定义Webhook消息推送API。主要API只有一个，必传参数也只有一个，因此没有使用门槛，如果不想去查询是否推送成功，只看消息推送接口即可。

消息推送接口

请求地址：https://www.phprm.com/services/push/send/xxxxxxxxxxxxxxxx
请求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/send/xxxxxxxxxxxxxxxx?head=默认标题&body=默认内容

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

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

参数说明

仅head参数必传，长度200个字符长度以内。

如果有延迟推送的需求，可以试试delayMilliseconds，如果有按年月日周期推送的需求，可以查看移动端官网。

如果您传递了url参数可以使用您个人博客或者公司网页进行预览消息，也可以使用markdown语法在body参数中嵌入网址。

body参数支持Markdown语法和emoji表情，移动端渲染效果很棒，例如公告类型消息的markdown模板如下：

# [点击查看公告](https://www.phprm.com/push/h5/)
邀请好友关注推送公众号【一封传话】。

![](https://www.phprm.com/push/h5/static/image/h5.png)

[免费公告推送H5页面](https://www.phprm.com/push/h5/)

[PC推送官网文档: http://push.phprm.com/doc/#/](http://push.phprm.com/doc/#/)

代码参考

<?php
echo file_get_contents("https://www.phprm.com/services/push/trigger/4d2dac865118761a14d10d7d3afe7c35?head=".urlencode("Markdown测试")."&body=".urlencode("# [点击查看公告](https://www.phprm.com/push/h5/)
邀请好友关注推送公众号【一封传话】。

![](https://www.phprm.com/push/h5/static/image/h5.png)

[免费公告推送H5页面:https://www.phprm.com/push/h5/]()

[PC推送官网文档: http://push.phprm.com/doc/#/](http://push.phprm.com/doc/#/)"));
?>

实际上只有一行代码, 只是为了渲染出如下效果（手机端体验最佳）才使用Markdown字符串作为body的参数：

在这里插入图片描述

Tips：传递url参数将自动跳转您个人/公司的网页，未传递url参数时【一封传话】将为您渲染Markdown图文预览页面。

在线调试与日志

Tips：官网首页支持在线测试，无需编写任何代码即可推送到微信上。

在这里插入图片描述

消息查询接口

请求地址：https://www.phprm.com/services/push/sendMessageResult/xxxxxxxxxxxxxxxx
请求URL上的xxxxxxxxxxxxxxxx, 是您创建消息通道的通道码
请求方式：?messageIds=1205957302260228096。如果有多个消息ID请使用英文,分隔传参。

参数名称	是否必填	默认值	说明
messageIds	是	无	最多支持5个消息ID查询

GET请求方式样例：

https://www.phprm.com/services/push/sendMessageResult/xxxxxxxxxxxxxxxx?messageIds=1205957302260228096,1205957305749889024

消息查询接口响应内容样例：

{
	"code": 0,
	"message": "请求成功",
	"data": {
		"1205957302260228096": {
			"messageId": "1205957302260228096",
			"pushTypeDesc": "官方邮件",
			"pushCount": 1,
			"viewCount": "0",
			"triggerTimeList": ["2023-02-10 19:23:46"],
			"handleTimeList": ["2023-02-10 19:23:49"],
			"readTimeList": [null],
			"handleCodeList": ["0"],
			"handleMsgList": [null]
		},
		"1205957305749889024": {
			"messageId": "1205957305749889024",
			"pushTypeDesc": "微信公众号",
			"pushCount": 1,
			"viewCount": "0",
			"triggerTimeList": ["2023-02-10 19:23:47"],
			"handleTimeList": ["2023-02-10 19:23:48"],
			"readTimeList": [null],
			"handleCodeList": ["0"],
			"handleMsgList": [null]
		}
	}
}