HiPush消息推送至你的微信、企业微信、钉钉、飞书、短信、邮件等。
支持使用GET/POST调用接口即可。
API推送地址:
Url:https://api.caicenter.com/send.php
GET调用示例1:
https://api.caicenter.com/send.php?appkey=xxxxxxxx&title=title&channel=1
[推送信息至微信公众号,标题为title]
GET调用示例2:
https://api.caicenter.com/send.php?appkey=xxxxxxxx&title=title&describes=test&channel=1|10&msg_type=text&cc_user=@all
[推送信息至微信公众号和微信群机器人,标题为title,内容为test,消息使用文本类型并提醒全员查看]
请替换url地址中的 xxxxxxx 为你自己的appkey
注:如果参数中有中文,请记得进行urlencode编码。
参数说明:
appkey:用户身份标识,请勿泄漏。[查看appkey]
title:消息的标题,必填。
describes:消息的内容,选填。如内容过多建议使用POST方式推送。
channel:指定推送消息的通道,默认为微信公众号通道。填写通道代码即可,多个通道请用|号隔开,如 10|20 代表同时推送至微信机器人和手机短信。
cc_user:特别提醒的人员。目前仅支持@all ,代表提醒全员查看。该参数仅通机器人通道有效。
msg_type:指定消息的类型,选填,可选值有 markdown、text,默认text。
支持的推送通道:
微信公众号:信息推送至Hi提醒公众。
企业微信应用消息:需要申请企业微信帐号(个人也可以)
企业微信群机器人消息:推送至你的企业微信群。
钉钉群机器人消息:推送至你的钉钉群。
飞书群机器人消息:推送至你的飞书群。
短信:需要绑定手机号。
语音电话:需要绑定手机号。
电子邮件:通过邮件方式发送到你的邮箱,需要绑定电子邮箱
通道名称及对应代码:
微信公众号:1
企业微信应用消息:10
企业微信群机器人消息:11
钉钉群机器人消息:12
飞书群机器人消息:13
短信:20
语音电话:30
电子邮件:40
POST调用示例:
<?php
//组合推送参数
$PUSH_DATA=array(
'title'=>'这是标题',
'describes'=>'这是内容',
'channel'=>'1|10',
'msg_type'=>'markdown',
'cc_user'=>'',
'appkey'=>'xxxxxxxxxxxxxx',
);
//正试推送
curl_post('https://api.caicenter.com/send.php' , $PUSH_DATA);
//post请求
function curl_post($URL , $data=array()){
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$output = curl_exec($ch);
curl_close($ch);
return $output;
}
?>
参数返回结果为json格式。
推送成功:
{"msg":"ok","code":0,"sendCode":"7tM154wFnRV3h","data":{"c_1":{"code":0,"msg":"推送成功"}}}
推送失败:
{"msg":"appKey已失效","code":110110}
code: 状态码, 0成功,>0失败
msg:错误信息说明
sendCode:消息标识码,可通过该参数查询接口推送结果。
data:消息通道体数据;c_1代表微信公众号通道的结果,其它通道同理。
-------------------------------------------------------------------
API查询推送结果:
https://api.caicenter.com/select.php?appkey=xxxxx&send_code=xxxxxxx
[替换xxxxxx为自己的appkey/send_code消息标识码]
返回结果:
查询成功:
{"code":0,"msg":"查询成功","data":[{"todoId":"0","channel":"1","pushTime":"2022-04-30 16:13:05","pushResult":{"code":0,"msg":"推送成功"},"status":"1"}]}
查询失败:
{"code":10013,"msg":"记录已过期或错误的推送代码(send_code)"}
更多配置详情参考Hi提醒的说明文档