你的token

我的好友

试一试

查看发送消息限制解封账号方法

实名认证用户无法调用发送消息接口。

发送结果查询

调用方式

更多使用方式查看消息接口文档在线测试接口

HTTP GET和DELETE请求

https://www.pushplus.plus/send?token=${_token_}&title=XXX&content=XXX&template=html&to=XXX

参数名称

是否必须

参数类型

默认值

描述

tokenquery用户令牌,可直接加到请求地址后,如:https://www.pushplus.plus/send/{token}?content=XXX
titlequery消息标题
contentquery具体消息内容,根据不同template支持不同格式。太长的消息内容用post请求,不要用get请求!
templatequeryhtml发送消息模板
toquery微信公众号渠道填写好友令牌,企业微信渠道填写企业微信用户id
channelquerywechat发送渠道
webhookquerywebhook编码
callbackUrlquery回调地址,异步回调发送结果
timestampquery时间戳,毫秒。如小于当前时间,消息将无法发送
prequery预处理信息编码。仅供会员使用。需要先在个人中心中添加预处理代码。

HTTP POST和PUT请求

https://www.pushplus.plus/send

Content-Type: application/json

参数名称

是否必须

参数类型

默认值

描述

tokenbody用户令牌
titlebody消息标题
contentbody具体消息内容,根据不同template支持不同格式
templatebodyhtml发送消息模板
tobody微信公众号渠道填写好友令牌,企业微信渠道填写企业微信用户id
channelbodywechat发送渠道
webhookbodywebhook编码
callbackUrlbody回调地址,异步回调发送结果
timestampbody时间戳,毫秒。如小于当前时间,消息将无法发送
prebody预处理信息编码。仅供会员使用。需要先在个人中心中添加预处理代码。

模板枚举

template消息模板枚举

模板名称

描述

使用教程

html支持html文本。为空默认使用html模板
txt纯文本内容,不转义html内容,换行使用\n
json可视化展示json格式内容
markdown内容基于markdown格式展示
cloudMonitor阿里云监控报警定制模板阿里云监控
jenkinsjenkins插件定制模板jenkins插件
route路由器插件定制模板路由器插件
pay支付成功通知模板支付成功模板教程

发送渠道枚举

channel发送渠道枚举

发送渠道

是否免费

描述

使用教程

wechat免费微信公众号,默认发送渠道
webhook免费第三方webhook服务;企业微信机器人、钉钉机器人、飞书机器人webhook渠道配置
cp免费企业微信应用企业微信应用配置
mail免费邮件邮件渠道使用说明
sms收费短信;收费使用,1条短信扣减10积分短信渠道配置

返回码说明

接口返回码说明

返回码

说明

200执行成功
302未登录
401请求未授权(排除开放接口功能是否启用)
403请求IP未授权(开放接口中排除是否将请求IP加入到白名单中)
500系统异常,请稍后再试
600数据异常,操作失败
805无权查看
888积分不足,需要充值
900用户账号使用受限(请求次数过多,停止继续请求)
905账户未进行实名认证(实名认证后即可发送消息)
903无效的用户令牌(发送消息使用的token不正确)
999服务端验证错误(具体查看返回内容)