API接口消息推送详解 | Hi提醒

该工具不但提供了API消息推送接口 还能创建提醒任务。

支持的提醒通道有很多 微信公众号、短信、邮件、企业微信、钉钉和飞书等都支持。

-----------------------------------------------------------

HiPush推送说明(API推送)

Api接口可以直接将信息推送至微信、企业微信、钉钉、飞书、短信、邮件等。

你只需简单设置好要推送的通道,使用GET/POST调用接口即可。

目前支持的通道:

微信公众号:信息推送至Hi提醒公众号,关注公众号即可。

企业微信应用消息:需要申请企业微信帐号(个人也可以),不用安装企业微信也能直接收到信息。[配置说明]

企业微信群机器人消息:推送至你的企业微信群。[配置说明]

钉钉群机器人消息:推送至你的钉钉群。[配置说明]

飞书群机器人消息:推送至你的飞书群。[配置说明]

短信:通过短信推送到你的手机,只需绑定手机号即可。

语音电话:通过语音电话推送到你的手机,只需绑定手机号即可。

电子邮件:通过邮件方式发送到你的邮箱,只需电子邮件即可。

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。

通道名称及对应代码:

微信公众号: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)"}

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容