一封传话聚合推送各语言demo代码示例

一封传话聚合推送各语言demo代码示例

前言

查看一封传话的API文档的GET请求只需一行代码，在url上拼接head和body参数即可完成推送。这里针对body数据量较大的情况，给出各语言实现的demo代码。

Tips：以下代码中的trigger与API文档中的send等价，trigger在send基础上做了高级特性增强处理，可以参考：一封传话聚合推送高级特性API
任何使用者都可以随意选择调用任何一个API，在API的使用方式上没有差异。

PHP语言

 $head,
        'body' => $body
        )
    );

$opts = array('http' =>
    array(
        'method'  => 'POST',
        'header'  => 'Content-type: application/json',
        'content' => $postdata
        )
    );
$context  = stream_context_create($opts);
$api_url = 'https://www.phprm.com/services/push/trigger/'.$channel_code;
$result = file_get_contents($api_url, false, $context);
echo $result;

如果你更倾向于使用curl库, 完全可以自己实现或者参考以下开源的三方库里的curl代码。

一些开源的三方库

1. 如果希望使用专业推送库, 可以参考此开源项目, 【一封传话】聚合推送SDK已经提交到Github和Gitee，通过composer可以直接安装SDK:

   • Github: https://github.com/guanguans/notify
   • Gitee: https://gitee.com/guanguans/notify

2. 提供博客系统新注册用户、新评论提醒插件, 可以参考插件源码或者直接在自己的网站使用：

   • WordPress插件: https://github.com/teakong/wordpress-tixing 或者 https://gitee.com/teakong/wordpress-tixing
   • Typecho插件: https://gitee.com/teakong/wordpress-tixing 或者 https://gitee.com/teakong/TypechoTixing
   • 其他博客或网站插件: https://github.com/teakong/liuyan-weixin 或者 https://gitee.com/teakong/liuyan-weixin

JAVA语言

建议使用Guava自带限流工具类, 例如10秒告警一次防止大量请求消耗你自己的服务器，如果使用redis分布式限流更好，这里还用到了Hutool工具包下的http请求类。

Hutool官网说明文档: https://hutool.cn/docs/#/
最新maven如下

    cn.hutool
    hutool-all
    5.8.11

java告警工具类demo：

import com.alibaba.fastjson2.JSONObject;
import com.google.common.util.concurrent.RateLimiter;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;

/**
 * Java系统告警工具类
 */
public class SystemAlarmUtil {

    private final static RateLimiter rateLimiter = RateLimiter.create(1d);

    private SystemAlarmUtil() {
        super();
    }

    public static String sendAlarmMessage(String title, String message) {
        try {
            // count 每次消耗的令牌10个, 那么每10秒才会通过一次 timeout 超时等待的时间, 等待超过1秒就拒绝发送
            if (!rateLimiter.tryAcquire(10, 1, TimeUnit.SECONDS)) {
                return null;
            }

            // 创建json对象作为requestBody
            JSONObject jsonObject = new JSONObject();
            jsonObject.put("head", title);
            jsonObject.put("body", message);
            // 添加请求头信息
            Map heads = new HashMap<>();
            // 使用json发送请求，下面的是必须的
            heads.put("Content-Type", "application/json;charset=UTF-8");
            HttpResponse response = HttpRequest.post("https://www.phprm.com/services/push/trigger/4d2dac865118761a14d10d7d3afe7c35")
                    .headerMap(heads, false).body(String.valueOf(jsonObject)).timeout(5 * 1000).execute();
            System.out.println("告警推送结果: "+response.body());
            return response.body();
        }
        catch (Exception exception) {

        }
        return null;
    }

    public static void main(String[] args) {
        SystemAlarmUtil.sendAlarmMessage("系统故障告警", "故障模块: 订单模块\n订单ID=xxxx\n订单金额: 100元\n故障原因: xxxx");
    }
}

由于java生态比较丰富，而且几乎所有人都有自己实现POST请求的工具类，这么就不提供SDK了。

Python语言

Python语言环境使用demo：

#coding:utf-8
import requests
import json
# 通道码/口令码
channel_code = '4d2dac865118761a14d10d7d3afe7c35'
head = '测试标题'
body = '测试内容'
headers={
'Content-Type': 'application/json'
}
url='https://www.phprm.com/services/push/send/'+channel_code
data={'head':head,'body':body}
res=requests.post(headers=headers,url=url,data=json.dumps(data),timeout=10)
print(json.dumps(res))

Go语言

Golang语言环境使用demo：

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
    "unsafe"
)

func SendMessage() error {
    channelCode := "4d2dac865118761a14d10d7d3afe7c35"
    message1 := make(map[string]interface{})
    message1["head"] = "测试标题"
    message1["body"] = "测试内容"
    bytesData, err := json.Marshal(message1)
    if err != nil {
        fmt.Println(err.Error() )
        return nil
    }
    reader := bytes.NewReader(bytesData)
    url := fmt.Sprintf("https://www.phprm.com/services/push/send/%s", channelCode)
    request, err := http.NewRequest("POST", url, reader)
    if err != nil {
        fmt.Println(err.Error())
        return nil
    }
    request.Header.Set("Content-Type", "application/json;charset=UTF-8")
    client := http.Client{}
    resp, err := client.Do(request)
    if err != nil {
        fmt.Println(err.Error())
        return nil
    }
    respBytes, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println(err.Error())
        return nil
    }
    str := (*string)(unsafe.Pointer(&respBytes))
    fmt.Println(*str)
    return nil
}

func main() {
    SendMessage()
}

C#语言

笔者暂未安装C#运行环境所以这里只提供GET请求，不过相信对C#熟悉的同学编写POST application/json请求不是难事。

// Get请求
string url = "https://www.phprm.com/services/push/send/4d2dac865118761a14d10d7d3afe7c35?head="
    + HttpUtility.UrlEncode("测试标题")
    + "&body="
    + HttpUtility.UrlEncode("测试内容" + DateTime.Now);
var response = await httpClient.GetAsync(url);
string res = await response.Content.ReadAsStringAsync();
Console.WriteLine("推送状态：" + response.StatusCode);
Console.WriteLine(res);

其他语言

敬请期待

参考：

https://www.phprm.com/push/h5/

http://push.phprm.com/doc/#/p/demo

一封传话推送工具API文档

一行代码实现微信消息推送

一封传话聚合推送高级特性API