# wxpusher-client

**Repository Path**: Angious/wxpusher-client

## Basic Information

- **Project Name**: wxpusher-client
- **Description**: 微信消息实时推送服务[WxPusher]，可以通过API实时给个人微信推送消息。wechat pusher.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2020-05-03
- **Last Updated**: 2023-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WxPusher
微信消息实时推送服务[WxPusher]，可以通过API实时给个人微信推送消息.[http://wxpusher.zjiecode.com/admin](http://wxpusher.zjiecode.com/admin)

# 使用说明

请直接访问官方说明文档[http://wxpusher.zjiecode.com/docs](http://wxpusher.zjiecode.com/docs)

## Java版本
[ ![version](https://img.shields.io/static/v1.svg?label=version&message=2.1.1&color=brightgreen) ](https://bintray.com/zjiecode/maven/wxpusher-client/1.0.0/link)

### gradle中使用

你需要添加Jcenter库，在“build.grade”中配置：
```groovy
dependencies {
    ......
    compile 'com.zjiecode:wxpusher-client:2.1.1'//使用上面的版本号
    ......
}
```

###  在maven中使用
在*pom.xml*文件中添加：
```xml
<dependency>
  <groupId>com.zjiecode</groupId>
  <artifactId>wxpusher-client</artifactId>
  <version>2.1.0</version>
  <type>pom</type>
</dependency>
```
### 发送消息
最后可以在你需要的地方，直接调用方法，即可实时推送消息到微信上了，比如下面这样：
```java
Message message = new Message();
message.setAppToken("AT_qHT0cTQfLwYOlBV9cJj9zDSyEmspsmyM");
message.setContentType(Message.CONTENT_TYPE_TEXT);
message.setContent("不加限制的自由是很可怕的，因为很容易让任何人滑向深渊。");
message.setUid("c1BcpqxEbD8irqlGUh9BhOqR2BvH8yWZ");
message.setUrl("http://wxpuser.zjiecode.com");
Result<List<MessageResult>> result = WxPusher.send(message);
```
### 创建带参数的二维码
创建一个带参数的二维码，用户扫码的时候，回调里面会携带二维码的参数.
```java
CreateQrcodeReq createQrcodeReq = new CreateQrcodeReq();
createQrcodeReq.setAppToken("xxxx"); //必填，应用的appTOken
createQrcodeReq.setExtra("parameter");//必填，携带的参数
createQrcodeReq.setValidTime(3600);//可选，二维码有效时间，默认1800 s，最大30天，单位是s
Result<CreateQrcodeResp> tempQrcode = WxPusher.createAppTempQrcode(createQrcodeReq);
if (tempQrcode.isSuccess()) {
    //创建成功
}
```


### 查询消息发送状态
发送消息是异步的，你可以通过这个api查询消息发送状态
```java
Result result = WxPusher.queryMessageStatus(messageId);
```

### 查询关注APP的微信用户列表
```java
Result<Page<WxUser>> wxUsers = WxPusher.queryWxUser("AT_xxxxx", 1, 50);
wxUsers.getData().getRecords().forEach(d-> System.out.println(d.getUid()));
```

使用就是这么简单，有需要就看快来试试吧。

## Go版本

安装

```sh
go get -u github.com/zjiecode/wxpusher-client
```

引入

```go
import "github.com/zjiecode/wxpusher-client/go/wxpusher"
```

### 发送消息

链式调用

```go
appToken := "AT_xxxxxxxx"
uId := "UID_xxxxxxxxxx"
result, err := wxpusher.NewMessage(appToken).SetContent("文本消息").AddUId(uId).Send()
```

或者直接构造

```go
appToken := "AT_xxxxxxxx"
uId := "UID_xxxxxxxxxx"
result, err := wxpusher.SendMessage(wxpusher.Message{
  AppToken:    appToken,
  Content:     "文本消息",
  ContentType: wxpusher.ContentText,
  UIds:        []string{uId},
})
```

### 查询消息发送状态

```go
messageId := 600
result, err := wxpusher.QueryMessageStatus(messageId)
```