jpush-api-go-client

概述

这是JPush REST API 的 go 版本封装开发包,仅支持最新的REST API v3功能，最近更新：2023-10-30。REST API 文档：https://docs.jiguang.cn/jpush/server/push/server_overview

使用

go install github.com/swordkee/jpush-api-go-client@latest

推送流程

1.构建要推送的平台： jpushclient.Platform

//Platform
var pf jpushclient.Platform
pf.AddAndroid().AddQuickApp().AddIOS()
//pf.All()

2.构建接收听众： jpushclient.Audience

//Audience
var ad jpushclient.Audience
s := []string{"t1", "t2", "t3"}
id := []string{"1", "2", "3"}
ad.SetTag(s).SetAlias(s).SetTagAnd(s).SetID([]string{registrationId}).SetTagNot(s)
//ad.All()

3.构建通知 jpushclient.Notice，或者消息： jpushclient.Message

//Notice
var notice jpushclient.Notice
notice.SetAlert("alert_test").
    SetAndroidNotice(&jpushclient.AndroidNotice{Alert: "AndroidNotice"}).
    SetIOSNotice(&jpushclient.IOSNotice{Alert: "IOSNotice"}).
    SetQuickAppNotice(&QuickAppNotice{Alert: "QuickAppNotice",Title: "test",Page: "/page"})
  
//jpushclient.Message
var msg jpushclient.Message
msg.SetTitle("Hello").SetMsgContent("test")

4.构建jpushclient.PayLoad

req := NewPushRequest()
req.SetPlatform(&pf).
    SetAudience(&ad).
    SetMessage(&msg).
    SetNotice(&notice).
    SetOptions(&op)

5.构建PushClient，发出推送

client := jpushclient.NewClient(secret, appKey)
result, err := client.Push(req)
if err != nil {
	fmt.Printf("err:%s", err.Error())
} else {
	fmt.Printf("ok:%s", r)
}

6.完整demo

package main

import (
	"fmt"
	"github.com/swordkee/jpush-api-go-client"
)

const (
	appKey = "you jpush appkey"
	secret = "you jpush secret"
)

func main() {

	//Platform
	var pf jpushclient.Platform
	pf.AddAndroid().AddQuickApp().AddIOS()
	//pf.All()

	//Audience
	var ad jpushclient.Audience
	s := []string{"1", "2", "3"}
	ad.SetTag(s).SetAlias(s).SetTagAnd(s).SetID([]string{registrationId}).SetTagNot(s)
	//ad.All()

	//Notice
	var notice jpushclient.Notice
	notice.SetAlert("alert_test").
	    SetAndroidNotice(&jpushclient.AndroidNotice{Alert: "AndroidNotice"}).
	    SetIOSNotice(&jpushclient.IOSNotice{Alert: "IOSNotice"}).
            SetQuickAppNotice(&QuickAppNotice{Alert: "QuickAppNotice",Title: "test",Page: "/page"})

	var msg jpushclient.Message
	msg.SetTitle("Hello").SetMsgContent("test")

	req := NewPushRequest()
        req.SetPlatform(&pf).
            SetAudience(&ad).
            SetMessage(&msg).
            SetNotice(&notice).
            SetOptions(&op)

	str, _ := req.ToJson()
	fmt.Printf("%s\r\n", str)

	//push
	c := jpushclient.NewClient(secret, appKey)
	result, err := c.Push(req)
	if err != nil {
		fmt.Printf("err:%s", err.Error())
	} else {
		fmt.Printf("ok:%s", result)
	}
}