1. 程式人生 > 其它 >如何配置HiPush 使用API訊息推送介面傳送資訊至手機或微信等通道

如何配置HiPush 使用API訊息推送介面傳送資訊至手機或微信等通道

HiPush是Hi提醒提供的API介面線上推送服務。使用GET/POST請求介面來推送訊息。

區別於[Hi提醒]需要提前建立好任務,HiPush在請求推送時才把資訊一起提交過來,完全自定義。

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)"}