Merge pull request #233 from silenceper/fix-go.mod

Fix go.mod

.github/ISSUE_TEMPLATE.md

@@ -1,3 +1,2 @@
 ## 问题及现象
-
 <!-- 描述你的问题现象，报错**贴截图**粘贴或者贴具体信息，提供**必要的代码段**

.github/ISSUE_TEMPLATE/bug.md

@@ -1,21 +0,0 @@
----
-name: 报告 Bug
-about: 反馈 BUG 信息
-title: "[BUG]"
-labels: bug
-assignees: ''
-
----
-
-**描述**
-
-**如何复现**
-步骤：
-1、
-2、
-
-**关联日志信息**
-
-
-**使用的版本**
- - SDK 版本：[比如 v0.0.0]

.github/ISSUE_TEMPLATE/feature.md

@@ -1,15 +0,0 @@
----
-name: API 需求
-about: 待实现的 API 接口，SDK 的强大离不开社区的帮助，欢迎为项目贡献 PR
-title: "[Feature]"
-labels: enhancement
-assignees: ''
-
----
-
-<!--
-!!!SDK 的强大离不开社区的帮助，欢迎为本项目贡献 PR!!!
--->
-**你想要实现的模块或 API**
-
-

.github/ISSUE_TEMPLATE/question.md

@@ -1,15 +0,0 @@
----
-name: 使用咨询
-about: 关于 SDK 使用相关的咨询，在使用前请先阅读官方微信文档
-title: "[咨询]"
-labels: question
-assignees: ''
-
----
-
-<!--
-重要：
-1、在使用本 SDK 前请先阅读对应的官方微信 API 文档：https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html
-2、本 SDK 部分接口文档：https://silenceper.com/wechat/
--->
-**请描述您的问题**

.github/workflows/go.yml

@@ -1,50 +0,0 @@
-name: Go
-
-on:
-  push:
-    branches: [ master,release-*,v2,feature/**,fix/** ]
-  pull_request:
-    branches: [ master,release-*,v2,feature/**,fix/** ]
-
-jobs:
-  golangci:
-    strategy:
-      matrix:
-        go-version:  [ '1.16','1.17','1.18','1.19','1.20','1.21.4' ]
-    name: golangci-lint
-    runs-on: ubuntu-latest
-    steps:
-      - name: Setup Golang ${{ matrix.go-version }}
-        uses: actions/setup-go@v5
-        with:
-          go-version: ${{ matrix.go-version }}
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: golangci-lint
-        uses: golangci/golangci-lint-action@v4
-        with:
-          # Required: the version of golangci-lint is required and must be specified without patch version: we always use the latest patch version.
-          version: v1.52.2
-  build:
-    name: Test
-    runs-on: ubuntu-latest
-    services:
-      memcached:
-        image: memcached
-        ports:
-          - 11211:11211
-
-    # strategy set
-    strategy:
-      matrix:
-        go: [ '1.16','1.17','1.18','1.19','1.20','1.21','1.22' ]
-
-    steps:
-      - uses: actions/checkout@v4
-      - name: Set up Go 1.x
-        uses: actions/setup-go@v5
-        with:
-          go-version: ${{ matrix.go }}
-        id: go
-      - name: Test
-        run: go test -v -race ./...

.gitignore

@@ -26,5 +26,4 @@ _testmain.go
 .vscode/
 vendor
 .idea/
-example/*
-/test
+examples/tcb/*

.golangci.yml

@@ -1,66 +0,0 @@
-linters:
-  # please, do not use `enable-all`: it's deprecated and will be removed soon.
-  # inverted configuration with `enable-all` and `disable` is not scalable during updates of golangci-lint
-  disable-all: true
-  enable:
-    - bodyclose
-    - deadcode
-    - depguard
-    - dogsled
-    - dupl
-    - errcheck
-    - funlen
-    - goconst
-      # - gocritic
-    - gocyclo
-    - gofmt
-    - goimports
-    - golint
-    - goprintffuncname
-    - gosimple
-    - govet
-    - ineffassign
-    - interfacer
-    - misspell
-    - nolintlint
-    - rowserrcheck
-    - scopelint
-    - staticcheck
-    - structcheck
-    - stylecheck
-    - typecheck
-    - unconvert
-    - unparam
-    - unused
-    - varcheck
-    - whitespace
-
-issues:
-  include:
-    - EXC0002 # disable excluding of issues about comments from golint
-  exclude-rules:
-    - linters:
-        - stylecheck
-      text: "ST1000:"
-  # Excluding configuration per-path, per-linter, per-text and per-source
-    - path: _test\.go
-      linters:
-        - gomnd
-
-    # https://github.com/go-critic/go-critic/issues/926
-    - linters:
-        - gocritic
-      text: "unnecessaryDefer:"
-
-linters-settings:
-  funlen:
-    lines: 66
-    statements: 50
-
-#issues:
-#  include:
-#  - EXC0002 # disable excluding of issues about comments from golint
-#  exclude-rules:
-#    - linters:
-#       - stylecheck
-#      text: "ST1000:"

.travis.yml

@@ -0,0 +1,19 @@
+language: go
+
+go:
+  - 1.13.x
+  - 1.12.x
+  - 1.11.x
+
+services:
+  - memcached
+  - redis-server
+
+before_script:
+  - GO_FILES=$(find . -iname '*.go' -type f | grep -v /vendor/)
+  - go get golang.org/x/lint/golint
+    
+script:
+  - go test -v -race ./...
+  - go vet ./...
+  - golint -set_exit_status $(go list ./...)

README.md

@@ -1,83 +1,642 @@
 # WeChat SDK for Go
-
-![Go](https://github.com/silenceper/wechat/workflows/Go/badge.svg?branch=release-2.0)
+[![Build Status](https://travis-ci.org/silenceper/wechat.svg?branch=master)](https://travis-ci.org/silenceper/wechat)
 [![Go Report Card](https://goreportcard.com/badge/github.com/silenceper/wechat)](https://goreportcard.com/report/github.com/silenceper/wechat)
-[![pkg](https://img.shields.io/badge/dev-reference-007d9c?logo=go&logoColor=white&style=flat)](https://pkg.go.dev/github.com/silenceper/wechat/v2?tab=doc)
-![version](https://img.shields.io/badge/version-v2-green)
+[![GoDoc](http://godoc.org/github.com/silenceper/wechat?status.svg)](http://godoc.org/github.com/silenceper/wechat)
 
 使用Golang开发的微信SDK，简单、易用。
-> 注意：当前版本为v2版本，v1版本已废弃
-
-## 文档 && 例子
-
-[API列表](https://github.com/silenceper/wechat/tree/v2/doc/api)
-
-[Wechat SDK 2.0 文档](https://silenceper.com/wechat)
-
-[Wechat SDK 2.0 例子](https://github.com/gowechat/example)
 
 ## 快速开始
 
-```
-import "github.com/silenceper/wechat/v2"
-```
-
-以下是一个微信公众号处理消息接收以及回复的例子：
+以下是一个处理消息接收以及回复的例子：
 
 ```go
-// 使用memcache保存access_token，也可选择redis或自定义cache
-wc := wechat.NewWechat()
-memory := cache.NewMemory()
-cfg := &offConfig.Config{
-    AppID:     "xxx",
-    AppSecret: "xxx",
-    Token:     "xxx",
-    // EncodingAESKey: "xxxx",
-    Cache: memory,
+//使用memcache保存access_token，也可选择redis或自定义cache
+memCache=cache.NewMemcache("127.0.0.1:11211")
+
+//配置微信参数
+config := &wechat.Config{
+	AppID:          "xxxx",
+	AppSecret:      "xxxx",
+	Token:          "xxxx",
+	EncodingAESKey: "xxxx",
+	Cache:          memCache
 }
-officialAccount := wc.GetOfficialAccount(cfg)
+wc := wechat.NewWechat(config)
 
 // 传入request和responseWriter
-server := officialAccount.GetServer(req, rw)
-// 设置接收消息的处理方法
-server.SetMessageHandler(func(msg *message.MixMessage) *message.Reply {
+server := wc.GetServer(request, responseWriter)
+server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
 
-    // 回复消息：演示回复用户发送的消息
-    text := message.NewText(msg.Content)
-    return &message.Reply{MsgType: message.MsgTypeText, MsgData: text}
+	//回复消息：演示回复用户发送的消息
+	text := message.NewText(msg.Content)
+	return &message.Reply{message.MsgTypeText, text}
 })
 
-// 处理消息接收以及回复
-err := server.Serve()
-if err != nil {
-    fmt.Println(err)
-    return
-}
-// 发送回复的消息
+server.Serve()
 server.Send()
 
 ```
+完整代码：[examples/http/http.go](./examples/http/http.go)
 
-## 目录说明
+#### 和主流框架配合使用
 
-- officialaccount: 微信公众号API
-- miniprogram: 小程序API
-- minigame:小游戏API
-- pay:微信支付API
-- openplatform:开放平台API
-- work:企业微信
-- aispeech:智能对话
-- doc: api文档
+主要是request和responseWriter在不同框架中获取方式可能不一样：
 
-## 贡献
+- Beego: [./examples/beego/beego.go](./examples/beego/beego.go)
+- Gin Framework: [./examples/gin/gin.go](./examples/gin/gin.go)
 
-- 在[API列表](https://github.com/silenceper/wechat/tree/v2/doc/api)中查看哪些API未实现
-- 提交issue，描述需要贡献的内容
-- 完成更改后，提交PR
+## 基本配置
 
-## 公众号
+```go
+memcache := cache.NewMemcache("127.0.0.1:11211")
 
-![img](https://silenceper.oss-cn-beijing.aliyuncs.com/qrcode/search_study_program.png)
+wcConfig := &wechat.Config{
+	AppID:          cfg.AppID,
+	AppSecret:      cfg.AppSecret,
+	Token:          cfg.Token,
+	EncodingAESKey: cfg.EncodingAESKey,//消息加解密时用到
+	Cache:          memcache,
+}
+```
+
+**Cache 设置**
+
+Cache主要用来保存全局access_token以及js-sdk中的ticket：
+默认采用memcache存储。当然也可以直接实现`cache/cache.go`中的接口
+
+
+## 基本API使用
+
+- [消息管理](#消息管理)
+	- 接收普通消息
+	- 接收事件推送
+	- 被动回复消息
+		- 回复文本消息
+		- 回复图片消息
+		- 回复视频消息
+		- 回复音乐消息
+		- 回复图文消息
+- [自定义菜单](#自定义菜单)
+	- 自定义菜单创建接口
+	- 自定义菜单查询接口
+	- 自定义菜单删除接口
+	- 自定义菜单事件推送
+	- 个性化菜单接口
+		- 添加个性化菜单
+		- 删除个性化菜单
+		- 测试个性化菜单匹配结果
+	- 获取公众号菜单配置
+- [微信网页开发](#微信网页开发)
+	- Oauth2 授权
+		- 发起授权
+		- 通过code换取access_token
+		- 拉取用户信息
+		- 刷新access_token
+		- 检验access_token是否有效
+	- 获取js-sdk配置
+- [素材管理](#素材管理)
+- [小程序开发](#小程序开发)
+- [小程序-云开发](./tcb)
+
+## 消息管理
+
+通过`wechat.GetServer(request,responseWriter)`获取到server对象之后
+
+调用`SetMessageHandler(func(msg message.MixMessage){})`设置消息的处理函数，函数参数为message.MixMessage 结构如下：
+
+```go
+//MixMessage 存放所有微信发送过来的消息和事件
+type MixMessage struct {
+	CommonToken
+
+	//基本消息
+	MsgID        int64   `xml:"MsgId"`
+	Content      string  `xml:"Content"`
+	PicURL       string  `xml:"PicUrl"`
+	MediaID      string  `xml:"MediaId"`
+	Format       string  `xml:"Format"`
+	ThumbMediaID string  `xml:"ThumbMediaId"`
+	LocationX    float64 `xml:"Location_X"`
+	LocationY    float64 `xml:"Location_Y"`
+	Scale        float64 `xml:"Scale"`
+	Label        string  `xml:"Label"`
+	Title        string  `xml:"Title"`
+	Description  string  `xml:"Description"`
+	URL          string  `xml:"Url"`
+
+	//事件相关
+	Event     string `xml:"Event"`
+	EventKey  string `xml:"EventKey"`
+	Ticket    string `xml:"Ticket"`
+	Latitude  string `xml:"Latitude"`
+	Longitude string `xml:"Longitude"`
+	Precision string `xml:"Precision"`
+
+	MenuID    string `xml:"MenuId"`
+
+	//扫码事件
+	ScanCodeInfo struct {
+		ScanType   string `xml:"ScanType"`
+		ScanResult string `xml:"ScanResult"`
+	} `xml:"ScanCodeInfo"`
+
+	//发图事件
+	SendPicsInfo struct {
+		Count   int32      `xml:"Count"`
+		PicList []EventPic `xml:"PicList>item"`
+	} `xml:"SendPicsInfo"`
+
+	//发送地理位置事件
+	SendLocationInfo struct {
+		LocationX float64 `xml:"Location_X"`
+		LocationY float64 `xml:"Location_Y"`
+		Scale     float64 `xml:"Scale"`
+		Label     string  `xml:"Label"`
+		Poiname   string  `xml:"Poiname"`
+	}
+}
+
+```
+
+具体参数请参考微信文档：[接收普通消息
+](http://mp.weixin.qq.com/wiki/17/f298879f8fb29ab98b2f2971d42552fd.html)
+
+### 接收普通消息
+```go
+server.SetMessageHandler(func(v message.MixMessage) *message.Reply {
+		switch v.MsgType {
+		//文本消息
+		case message.MsgTypeText:
+			//do something
+
+			//图片消息
+		case message.MsgTypeImage:
+			//do something
+
+			//语音消息
+		case message.MsgTypeVoice:
+			//do something
+
+			//视频消息
+		case message.MsgTypeVideo:
+			//do something
+
+			//小视频消息
+		case message.MsgTypeShortVideo:
+			//do something
+
+			//地理位置消息
+		case message.MsgTypeLocation:
+			//do something
+
+			//链接消息
+		case message.MsgTypeLink:
+			//do something
+
+			//事件推送消息
+		case message.MsgTypeEvent:
+
+		}
+}
+
+
+```
+
+
+### 接收事件推送
+```go
+//事件推送消息
+case message.MsgTypeEvent:
+	switch v.Event {
+		//EventSubscribe 订阅
+		case message.EventSubscribe:
+			//do something
+
+			//取消订阅
+		case message.EventUnsubscribe:
+			//do something
+
+			//用户已经关注公众号，则微信会将带场景值扫描事件推送给开发者
+		case message.EventScan:
+			//do something
+
+			// 上报地理位置事件
+		case message.EventLocation:
+			//do something
+
+			// 点击菜单拉取消息时的事件推送
+		case message.EventClick:
+			//do something
+
+			// 点击菜单跳转链接时的事件推送
+		case message.EventView:
+			//do something
+
+			// 扫码推事件的事件推送
+		case message.EventScancodePush:
+			//do something
+
+			// 扫码推事件且弹出“消息接收中”提示框的事件推送
+		case message.EventScancodeWaitmsg:
+			//do something
+
+			// 弹出系统拍照发图的事件推送
+		case message.EventPicSysphoto:
+			//do something
+
+			// 弹出拍照或者相册发图的事件推送
+		case message.EventPicPhotoOrAlbum:
+			//do something
+
+			// 弹出微信相册发图器的事件推送
+		case message.EventPicWeixin:
+			//do something
+
+			// 弹出地理位置选择器的事件推送
+		case message.EventLocationSelect:
+			//do something
+
+	}
+
+
+```
+
+
+### 被动回复消息
+
+回复消息需要返回 `*message.Reply` 对象结构体如下：
+
+```go
+type Reply struct {
+	MsgType MsgType  //消息类型
+	MsgData interface{}  //消息结构
+}
+
+```
+注意：`return nil`表示什么也不做
+
+####  回复文本消息
+```go
+	text := message.NewText("回复文本消息")
+	return &message.Reply{message.MsgTypeText, text}
+```
+####  回复图片消息
+```go
+//mediaID 可通过素材管理-上上传多媒体文件获得
+image :=message.NewImage("mediaID")
+return &message.Reply{message.MsgTypeImage, image}
+```
+####  回复视频消息
+```go
+video := message.NewVideo("mediaID", "视频标题", "视频描述")
+return &message.Reply{message.MsgTypeVideo, video}
+```
+####  回复音乐消息
+```go
+music := message.NewMusic("title", "description", "musicURL", "hQMusicURL", "thumbMediaID")
+return &message.Reply{message.MsgTypeMusic,music}
+```
+**字段说明：**
+
+Title:音乐标题
+
+Description:音乐描述
+
+MusicURL:音乐链接
+
+HQMusicUrl：高质量音乐链接，WIFI环境优先使用该链接播放音乐
+
+ThumbMediaId：缩略图的媒体id，通过素材管理接口上传多媒体文件，得到的id
+
+####  回复图文消息
+
+```go
+articles := make([]*message.Article, 1)
+
+article := new(message.Article)
+article.Title = "标题"
+article.Description = "描述信息信息信息"
+article.PicURL = "http://ww1.sinaimg.cn/large/65209136gw1f7vhjw95eqj20wt0zk40z.jpg"
+article.URL = "https://github.com/silenceper/wechat"
+articles[0] = article
+
+news := message.NewNews(articles)
+return &message.Reply{message.MsgTypeNews,news}
+```
+**字段说明：**
+
+Title：图文消息标题
+
+Description：图文消息描述
+
+PicUrl	：图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200
+
+Url	：点击图文消息跳转链接
+
+
+## 自定义菜单
+
+通过` wechat.GetMenu()`获取menu的实例
+
+### 自定义菜单创建接口
+
+以下是一个创建二级菜单的例子
+
+```go
+mu := wc.GetMenu()
+
+buttons := make([]*menu.Button, 1)
+btn := new(menu.Button)
+
+//创建click类型菜单
+btn.SetClickButton("name", "key123")
+buttons[0] = btn
+
+//设置btn为二级菜单
+btn2 := new(menu.Button)
+btn2.SetSubButton("subButton", buttons)
+
+buttons2 := make([]*menu.Button, 1)
+buttons2[0] = btn2
+
+//发送请求
+err := mu.SetMenu(buttons2)
+if err != nil {
+	fmt.Printf("err= %v", err)
+	return
+}
+
+```
+
+**创建其他类型的菜单：**
+
+```go
+//SetViewButton view类型
+func (btn *Button) SetViewButton(name, url string)
+
+// SetScanCodePushButton 扫码推事件
+func (btn *Button) SetScanCodePushButton(name, key string)
+
+//SetScanCodeWaitMsgButton 设置 扫码推事件且弹出"消息接收中"提示框
+func (btn *Button) SetScanCodeWaitMsgButton(name, key string)
+
+//SetPicSysPhotoButton 设置弹出系统拍照发图按钮
+func (btn *Button) SetPicSysPhotoButton(name, key string)
+
+//SetPicPhotoOrAlbumButton 设置弹出拍照或者相册发图类型按钮
+func (btn *Button) SetPicPhotoOrAlbumButton(name, key string) {
+
+// SetPicWeixinButton 设置弹出微信相册发图器类型按钮
+func (btn *Button) SetPicWeixinButton(name, key string)
+
+// SetLocationSelectButton 设置 弹出地理位置选择器 类型按钮
+func (btn *Button) SetLocationSelectButton(name, key string)
+
+//SetMediaIDButton  设置 下发消息(除文本消息) 类型按钮
+func (btn *Button) SetMediaIDButton(name, mediaID string)
+
+//SetViewLimitedButton  设置 跳转图文消息URL 类型按钮
+func (btn *Button) SetViewLimitedButton(name, mediaID string) {
+
+```
+
+### 自定义菜单查询接口
+
+```go
+mu := wc.GetMenu()
+resMenu,err:=mu.GetMenu()
+```
+>返回结果 resMenu 结构参考 ./menu/menu.go 中ResMenu 结构体
+
+### 自定义菜单删除接口
+
+```go
+mu := wc.GetMenu()
+err:=mu.DeleteMenu()
+```
+
+### 自定义菜单事件推送
+
+ 请参考 消息管理 - 事件推送
+
+### 个性化菜单接口
+**添加个性化菜单**
+
+```go
+
+func (menu *Menu) AddConditional(buttons []*Button, matchRule *MatchRule) error
+```
+
+**删除个性化菜单**
+
+```go
+//删除个性化菜单
+func (menu *Menu) DeleteConditional(menuID int64) error
+
+```
+**测试个性化菜单匹配结果**
+
+```go
+//菜单匹配
+func (menu *Menu) MenuTryMatch(userID string) (buttons []Button, err error) {
+
+```
+
+### 获取公众号菜单配置
+
+```go
+//获取自定义菜单配置接口
+func (menu *Menu) GetCurrentSelfMenuInfo() (resSelfMenuInfo ResSelfMenuInfo, err error)
+
+```
+
+## 微信网页开发
+
+### Oauth2 授权
+
+具体授权流程请参考微信文档：[网页授权](http://mp.weixin.qq.com/wiki/4/9ac2e7b1f1d22e9e57260f6553822520.html)
+
+**1.发起授权**
+
+```go
+oauth := wc.GetOauth()
+err := oauth.Redirect("跳转的绝对地址", "snsapi_userinfo", "123dd123")
+if err != nil {
+	fmt.Println(err)
+}
+
+```
+> 如果不希望直接跳转，可通过 oauth.GetRedirectURL 获取跳转的url
+
+**2.通过code换取access_token**
+
+```go
+code := c.Query("code")
+resToken, err := oauth.GetUserAccessToken(code)
+if err != nil {
+	fmt.Println(err)
+	return
+}
+
+```
+**3.拉取用户信息(需scope为 snsapi_userinfo)**
+
+```go
+//getUserInfo
+userInfo, err := oauth.GetUserInfo(resToken.AccessToken, resToken.OpenID)
+if err != nil {
+	fmt.Println(err)
+	return
+}
+fmt.Println(userInfo)
+
+```
+**刷新access_token**
+
+```go
+func (oauth *Oauth) RefreshAccessToken(refreshToken string) (result ResAccessToken, err error)
+
+```
+**检验access_token是否有效**
+
+```go
+func (oauth *Oauth) CheckAccessToken(accessToken, openID string) (b bool, err error)
+```
+
+### 获取js-sdk配置
+
+```go
+js := wc.GetJs()
+cfg, err := js.GetConfig("传入需要的调用js-sdk的url地址")
+if err != nil {
+	fmt.Println(err)
+	return
+}
+fmt.Println(cfg)
+```
+其中返回的cfg结构体如下：
+
+```go
+type Config struct {
+	AppID     string `json:"app_id"`
+	Timestamp int64  `json:"timestamp"`
+	NonceStr  string `json:"nonce_str"`
+	Signature string `json:"signature"`
+}
+
+```
+
+## 素材管理
+
+[素材管理API](https://godoc.org/github.com/silenceper/wechat/material#Material)
+
+## 小程序开发
+
+获取小程序操作对象
+
+``` go
+memCache=cache.NewMemcache("127.0.0.1:11211")
+config := &wechat.Config{
+	AppID:     "xxx",
+	AppSecret: "xxx",
+	Cache:     memCache=cache.NewMemcache("127.0.0.1:11211"),
+}
+wc := wechat.NewWechat(config)
+
+wxa := wc.GetMiniProgram()
+```
+
+### 小程序登录凭证校验
+
+``` go
+func (wxa *MiniProgram) Code2Session(jsCode string) (result ResCode2Session, err error)
+```
+
+### 小程序数据统计
+
+**获取用户访问小程序日留存**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisDailyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error)
+```
+
+**获取用户访问小程序月留存**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisMonthlyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error)
+```
+
+**获取用户访问小程序周留存**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisWeeklyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error)
+```
+
+**获取用户访问小程序数据概况**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisDailySummary(beginDate, endDate string) (result ResAnalysisDailySummary, err error)
+```
+
+**获取用户访问小程序数据日趋势**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisDailyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error)
+```
+
+**获取用户访问小程序数据月趋势**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisMonthlyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error)
+```
+
+**获取用户访问小程序数据周趋势**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisWeeklyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error)
+```
+
+**获取小程序新增或活跃用户的画像分布数据**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisUserPortrait(beginDate, endDate string) (result ResAnalysisUserPortrait, err error)
+```
+
+**获取用户小程序访问分布数据**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisVisitDistribution(beginDate, endDate string) (result ResAnalysisVisitDistribution, err error)
+```
+
+**获取小程序页面访问数据**
+
+``` go
+func (wxa *MiniProgram) GetAnalysisVisitPage(beginDate, endDate string) (result ResAnalysisVisitPage, err error)
+```
+
+### 小程序二维码生成
+
+**获取小程序二维码，适用于需要的码数量较少的业务场景**
+
+``` go
+func (wxa *MiniProgram) CreateWXAQRCode(coderParams QRCoder) (response []byte, err error)
+```
+
+**获取小程序码，适用于需要的码数量较少的业务场景**
+
+``` go
+func (wxa *MiniProgram) GetWXACode(coderParams QRCoder) (response []byte, err error)
+```
+
+**获取小程序码，适用于需要的码数量极多的业务场景**
+
+``` go
+func (wxa *MiniProgram) GetWXACodeUnlimit(coderParams QRCoder) (response []byte, err error)
+```
+
+
+更多API使用请参考 godoc ：
+[https://godoc.org/github.com/silenceper/wechat](https://godoc.org/github.com/silenceper/wechat)
 
 ## License
 

aispeech/README.md

@@ -1,5 +0,0 @@
-# 智能对话
-
-[官方文档](https://developers.weixin.qq.com/doc/aispeech/platform/INTERFACEDOCUMENT.html)
-
-## 快速入门

cache/cache.go

@@ -1,55 +1,11 @@
 package cache
 
-import (
-	"context"
-	"time"
-)
+import "time"
 
-// Cache interface
+//Cache interface
 type Cache interface {
 	Get(key string) interface{}
 	Set(key string, val interface{}, timeout time.Duration) error
 	IsExist(key string) bool
 	Delete(key string) error
 }
-
-// ContextCache interface
-type ContextCache interface {
-	Cache
-	GetContext(ctx context.Context, key string) interface{}
-	SetContext(ctx context.Context, key string, val interface{}, timeout time.Duration) error
-	IsExistContext(ctx context.Context, key string) bool
-	DeleteContext(ctx context.Context, key string) error
-}
-
-// GetContext get value from cache
-func GetContext(ctx context.Context, cache Cache, key string) interface{} {
-	if cache, ok := cache.(ContextCache); ok {
-		return cache.GetContext(ctx, key)
-	}
-	return cache.Get(key)
-}
-
-// SetContext set value to cache
-func SetContext(ctx context.Context, cache Cache, key string, val interface{}, timeout time.Duration) error {
-	if cache, ok := cache.(ContextCache); ok {
-		return cache.SetContext(ctx, key, val, timeout)
-	}
-	return cache.Set(key, val, timeout)
-}
-
-// IsExistContext check value exists in cache.
-func IsExistContext(ctx context.Context, cache Cache, key string) bool {
-	if cache, ok := cache.(ContextCache); ok {
-		return cache.IsExistContext(ctx, key)
-	}
-	return cache.IsExist(key)
-}
-
-// DeleteContext delete value in cache.
-func DeleteContext(ctx context.Context, cache Cache, key string) error {
-	if cache, ok := cache.(ContextCache); ok {
-		return cache.DeleteContext(ctx, key)
-	}
-	return cache.Delete(key)
-}

cache/memcache.go

@@ -7,18 +7,18 @@ import (
 	"github.com/bradfitz/gomemcache/memcache"
 )
 
-// Memcache struct contains *memcache.Client
+//Memcache struct contains *memcache.Client
 type Memcache struct {
 	conn *memcache.Client
 }
 
-// NewMemcache create new memcache
+//NewMemcache create new memcache
 func NewMemcache(server ...string) *Memcache {
 	mc := memcache.New(server...)
 	return &Memcache{mc}
 }
 
-// Get return cached value
+//Get return cached value
 func (mem *Memcache) Get(key string) interface{} {
 	var err error
 	var item *memcache.Item
@@ -40,7 +40,7 @@ func (mem *Memcache) IsExist(key string) bool {
 	return true
 }
 
-// Set cached value with key and expire time.
+//Set cached value with key and expire time.
 func (mem *Memcache) Set(key string, val interface{}, timeout time.Duration) (err error) {
 	var data []byte
 	if data, err = json.Marshal(val); err != nil {
@@ -51,7 +51,7 @@ func (mem *Memcache) Set(key string, val interface{}, timeout time.Duration) (er
 	return mem.conn.Set(item)
 }
 
-// Delete delete value in memcache.
+//Delete delete value in memcache.
 func (mem *Memcache) Delete(key string) error {
 	return mem.conn.Delete(key)
 }

cache/memcache_test.go

@@ -3,9 +3,6 @@ package cache
 import (
 	"testing"
 	"time"
-
-	"github.com/bradfitz/gomemcache/memcache"
-	"github.com/stretchr/testify/assert"
 )
 
 func TestMemcache(t *testing.T) {
@@ -19,22 +16,13 @@ func TestMemcache(t *testing.T) {
 	if !mem.IsExist("username") {
 		t.Error("IsExist Error")
 	}
-	exists := mem.IsExist("unknown-key")
-	assert.Equal(t, false, exists)
 
 	name := mem.Get("username").(string)
-	if name != "" {
-		if name != "silenceper" {
-			t.Error("get Error")
-		}
+	if name != "silenceper" {
+		t.Error("get Error")
 	}
-	data := mem.Get("unknown-key")
-	assert.Nil(t, data)
 
 	if err = mem.Delete("username"); err != nil {
 		t.Errorf("delete Error , err=%v", err)
 	}
-
-	err = mem.Delete("unknown-key")
-	assert.Equal(t, memcache.ErrCacheMiss, err)
 }

cache/memory.go

@@ -5,7 +5,7 @@ import (
 	"time"
 )
 
-// Memory struct contains *memcache.Client
+//Memory struct contains *memcache.Client
 type Memory struct {
 	sync.Mutex
 
@@ -17,14 +17,14 @@ type data struct {
 	Expired time.Time
 }
 
-// NewMemory create new memcache
+//NewMemory create new memcache
 func NewMemory() *Memory {
 	return &Memory{
 		data: map[string]*data{},
 	}
 }
 
-// Get return cached value
+//Get return cached value
 func (mem *Memory) Get(key string) interface{} {
 	if ret, ok := mem.data[key]; ok {
 		if ret.Expired.Before(time.Now()) {
@@ -48,7 +48,7 @@ func (mem *Memory) IsExist(key string) bool {
 	return false
 }
 
-// Set cached value with key and expire time.
+//Set cached value with key and expire time.
 func (mem *Memory) Set(key string, val interface{}, timeout time.Duration) (err error) {
 	mem.Lock()
 	defer mem.Unlock()
@@ -60,15 +60,15 @@ func (mem *Memory) Set(key string, val interface{}, timeout time.Duration) (err
 	return nil
 }
 
-// Delete delete value in memcache.
+//Delete delete value in memcache.
 func (mem *Memory) Delete(key string) error {
-	mem.deleteKey(key)
-	return nil
+	return mem.deleteKey(key)
 }
 
 // deleteKey
-func (mem *Memory) deleteKey(key string) {
+func (mem *Memory) deleteKey(key string) error {
 	mem.Lock()
 	defer mem.Unlock()
 	delete(mem.data, key)
+	return nil
 }

cache/redis.go

@@ -0,0 +1,109 @@
+package cache
+
+import (
+	"encoding/json"
+	"time"
+
+	"github.com/gomodule/redigo/redis"
+)
+
+//Redis redis cache
+type Redis struct {
+	conn *redis.Pool
+}
+
+//RedisOpts redis 连接属性
+type RedisOpts struct {
+	Host        string `yml:"host" json:"host"`
+	Password    string `yml:"password" json:"password"`
+	Database    int    `yml:"database" json:"database"`
+	MaxIdle     int    `yml:"max_idle" json:"max_idle"`
+	MaxActive   int    `yml:"max_active" json:"max_active"`
+	IdleTimeout int32  `yml:"idle_timeout" json:"idle_timeout"` //second
+}
+
+//NewRedis 实例化
+func NewRedis(opts *RedisOpts) *Redis {
+	pool := &redis.Pool{
+		MaxActive:   opts.MaxActive,
+		MaxIdle:     opts.MaxIdle,
+		IdleTimeout: time.Second * time.Duration(opts.IdleTimeout),
+		Dial: func() (redis.Conn, error) {
+			return redis.Dial("tcp", opts.Host,
+				redis.DialDatabase(opts.Database),
+				redis.DialPassword(opts.Password),
+			)
+		},
+		TestOnBorrow: func(conn redis.Conn, t time.Time) error {
+			if time.Since(t) < time.Minute {
+				return nil
+			}
+			_, err := conn.Do("PING")
+			return err
+		},
+	}
+	return &Redis{pool}
+}
+
+//SetConn 设置conn
+func (r *Redis) SetConn(conn *redis.Pool) {
+	r.conn = conn
+}
+
+//Get 获取一个值
+func (r *Redis) Get(key string) interface{} {
+	conn := r.conn.Get()
+	defer conn.Close()
+
+	var data []byte
+	var err error
+	if data, err = redis.Bytes(conn.Do("GET", key)); err != nil {
+		return nil
+	}
+	var reply interface{}
+	if err = json.Unmarshal(data, &reply); err != nil {
+		return nil
+	}
+
+	return reply
+}
+
+//Set 设置一个值
+func (r *Redis) Set(key string, val interface{}, timeout time.Duration) (err error) {
+	conn := r.conn.Get()
+	defer conn.Close()
+
+	var data []byte
+	if data, err = json.Marshal(val); err != nil {
+		return
+	}
+
+	_, err = conn.Do("SETEX", key, int64(timeout/time.Second), data)
+
+	return
+}
+
+//IsExist 判断key是否存在
+func (r *Redis) IsExist(key string) bool {
+	conn := r.conn.Get()
+	defer conn.Close()
+
+	a, _ := conn.Do("EXISTS", key)
+	i := a.(int64)
+	if i > 0 {
+		return true
+	}
+	return false
+}
+
+//Delete 删除
+func (r *Redis) Delete(key string) error {
+	conn := r.conn.Get()
+	defer conn.Close()
+
+	if _, err := conn.Do("DEL", key); err != nil {
+		return err
+	}
+
+	return nil
+}

cache/redis_test.go

@@ -0,0 +1,32 @@
+package cache
+
+import (
+	"testing"
+	"time"
+)
+
+func TestRedis(t *testing.T) {
+	opts := &RedisOpts{
+		Host: "127.0.0.1:6379",
+	}
+	redis := NewRedis(opts)
+	var err error
+	timeoutDuration := 1 * time.Second
+
+	if err = redis.Set("username", "silenceper", timeoutDuration); err != nil {
+		t.Error("set Error", err)
+	}
+
+	if !redis.IsExist("username") {
+		t.Error("IsExist Error")
+	}
+
+	name := redis.Get("username").(string)
+	if name != "silenceper" {
+		t.Error("get Error")
+	}
+
+	if err = redis.Delete("username"); err != nil {
+		t.Errorf("delete Error , err=%v", err)
+	}
+}

cloudbase/README.md

@@ -0,0 +1,53 @@
+# 小程序-云开发 SDK
+
+[云开发（CloudBase）](https://www.cloudbase.net/)是基于Serverless架构构建的一站式后端云服务，涵盖函数、数据库、存储、CDN等服务，免后端运维，支持小程序、Web和APP开发。 其中，小程序·云开发是微信和腾讯云联合推出的云端一体化解决方案，基于云开发可以免鉴权调用微信所有开放能力，在微信开发者工具中即可开通使用。
+
+
+
+## 使用说明
+**引入依赖**
+>推荐使用go module 进行管理
+
+```
+go get github.com/silenceper/wechat@v1.2.3
+```
+
+**初始化配置**
+
+```golang
+//使用memcache保存access_token，也可选择redis或自定义cache
+memCache=cache.NewMemcache("127.0.0.1:11211")
+
+//配置小程序参数
+config := &wechat.Config{
+    AppID:     "your app id",
+    AppSecret: "your app secret",
+    Cache:     memCache,
+}
+wc := wechat.NewWechat(config)
+wcTcb := wc.GetTcb()
+```
+
+### 使用API
+
+#### 触发云函数
+```golang
+res, err := wcTcb.InvokeCloudFunction("test-xxxx", "add", `{"a":1,"b":2}`)
+if err != nil {
+    panic(err)
+}
+```
+
+更多使用方法参考[pkg.go.dev](https://pkg.go.dev/github.com/silenceper/wechat@v1.2.3/tcb?tab=doc#Tcb)
+
+## Demo
+### 使用wechat sdk开发一个留言板
+
+这是一个使用wechat sdk来完成一个留言板的例子，使用到了云开发中的云函数，数据库，存储API：
+
+- [起步：项目搭建](./guestbook-demo/start.md)
+- [数据库：调用云开发数据库实现文本保存](./guestbook-demo/database.md)
+- [云函数：调用云函数实现文本过滤](./guestbook-demo/cloudfunctions.md)
+- [云开发存储：实现留言本附件上传](./guestbook-demo/storage.md)
+
+以上文中的所有代码都上传在 [https://github.com/go-demo/guestbook](https://github.com/go-demo/guestbook)

cloudbase/guestbook-demo/cloudfunctions.md

@@ -0,0 +1,100 @@
+# 云开发存储：实现留言本附件上传
+## API说明
+云开发中云函数[文档说明](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/functions/)，可以先阅读原始http api需要的参数以及说明
+
+**基本流程：**
+
+1. 创建云函数
+1. 通过微信开发者工具编写云函数
+1. 利用SDK实现云函数的调用
+
+云函数调用主要使用到了sdk中 `InvokeCloudFunction` 方法的使用：
+
+```go
+func (tcb *Tcb) InvokeCloudFunction(env, name, args string) (*InvokeCloudFunctionRes, error)
+```
+**参数说明：**<br />1、第一个参数为云开发的环境<br />2、第二个参数为云函数名称<br />3、第三个参数为需要传入的参数，这里传入一个json，方便在云函数中接收并处理，函数的返回值也是json<br />**<br />**返回结果：**
+
+```go
+type InvokeCloudFunctionRes struct {
+	util.CommonError
+	RespData string `json:"resp_data"` //云函数返回的buffer
+}
+```
+
+> util.CommonError ：包含了errcode和errmsg字段，因为微信http api中的返回结果都会包含这两个字段，所以作为了一个公共的struct
+
+
+这里演示如何通过云函数实现对文本内容的过滤，比如对关键字的过滤。
+<a name="s4cYj"></a>
+## 创建一个云函数
+打开微信开发者工具，在cloudfunctions中创建一个filterText云函数：<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1580023609925-93d7ece7-636f-46c8-83b8-be12a41c5f51.png#align=left&display=inline&height=236&name=image.png&originHeight=472&originWidth=746&size=75078&status=done&style=none&width=373)
+
+其中index.js文本内容实现了对关键字的替换，内容如下：
+
+```javascript
+// 云函数入口文件
+//敏感词
+var keywords = ["色情"]
+
+// 云函数入口函数
+exports.main = async(event, context) => {
+  let {
+    text
+  } = event
+  keywords.map(word => {
+    let regExp = new RegExp(word, 'g')
+    text = text.replace(regExp, "****")
+  })
+  return {
+    text
+  }
+}
+```
+
+这里实现了对关键字 `色情` 替换为 `****` 。
+<a name="MIN25"></a>
+## 调用云函数
+
+在feedbackService中创建FilterText函数实现对云函数的调用，传入原始文本内容，返回最终过滤之后的内容。
+
+```go
+//FilterRes 过滤文件的结果
+type FilterRes struct {
+	Text string `json:"text"`
+}
+
+//FilterText 调用云函数过滤文本
+func (svc *FeedbackService) FilterText(text string) (string, error) {
+	res, err := getTcb().InvokeCloudFunction(getConfig().TcbEnv, "filterText", fmt.Sprintf(`{"text":"%s"}`, text))
+	//返回的是json
+	filterRes := &FilterRes{}
+	err = json.Unmarshal([]byte(res.RespData), filterRes)
+	if err != nil {
+		return "", nil
+	}
+
+	return filterRes.Text, nil
+}
+```
+这里将云函数调用的返回值保存在FilterRes struct中。
+
+最后再 feedbackService中的 `Save` 对Content内容进行替换：
+
+```go
+//Save 保存内容
+func (svc *FeedbackService) Save(feedback *Feedback) error {
+	.....
+	//content 调用云函数过滤
+	var err error
+	feedback.Content, err = svc.FilterText(feedback.Content)
+	if err != nil {
+		return err
+	}
+    ....
+}
+```
+
+最终的效果如下，当我们输入了含有关键字的留言内容最终就会被替换为****：<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1580024391966-3cf8aab1-6630-4b5d-b172-150f6b43e53c.png#align=left&display=inline&height=155&name=image.png&originHeight=310&originWidth=1284&size=23217&status=done&style=none&width=642)
+
+

cloudbase/guestbook-demo/database.md

@@ -0,0 +1,306 @@
+# 数据库：调用云开发数据库实现文本保存
+
+在这一节，我们主要描述如何利用`wechat sdk`将留言的内容保存在云开发数据库中。
+
+<a name="RjeGP"></a>
+## API说明
+参考微信云开发文档 [数据库篇](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/database/#%E6%95%B0%E6%8D%AE%E5%BA%93)，可以先阅读其原始的api提供的方法和说明，在[SDK DOC](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#Tcb.DatabaseAdd)中都可以找到对应的方法以及参数。
+
+主要利用到[SDK DOC](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#Tcb.DatabaseAdd)中的如下方法，其他方法可在文档中找到，sdk文档中以 `Database` 开头的方法即为数据库相关的方法调用。
+```go
+func (tcb *Tcb) DatabaseAdd(env, query string) (*DatabaseAddRes, error) //数据库内容保存
+func (tcb *Tcb) DatabaseCount(env, query string) (*DatabaseCountRes, error)//数据库计数
+func (tcb *Tcb) DatabaseQuery(env, query string) (*DatabaseQueryRes, error)//数据库内容查询
+```
+返回结果对应字段说明： [`DatabaseAddRes`](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#DatabaseAddRes) ， [`DatabaseCountRes`](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#DatabaseCountRes) , [`DatabaseQueryRes`](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#DatabaseQueryRes) 
+
+<a name="VKuDQ"></a>
+## 包引入
+本例中引入的WeChat sdk版本为v1.2.3版本，通过如下方法引入
+```bash
+go get github.com/silenceper/wechat@v1.2.3
+```
+可以在go.mod文件中看到引入的包以及对应的版本：
+```go
+module github.com/go-demo/guestbook
+
+go 1.13
+
+require (
+	github.com/gin-gonic/gin v1.5.0
+	github.com/silenceper/wechat v1.2.3 // indirect
+)
+```
+
+<a name="m7jnm"></a>
+## 保存至云开发数据库
+<a name="a095b5de"></a>
+### WeChat SDK配置
+为了方便在其他方法中调用<br />创建config.go用于解析云开发对应的配置参数，appkey，app_secret等：
+
+```go
+package main
+
+import (
+	"io/ioutil"
+
+	"github.com/silenceper/wechat"
+	"github.com/silenceper/wechat/cache"
+	"github.com/silenceper/wechat/tcb"
+	"gopkg.in/yaml.v2"
+)
+
+//Config 配置信息
+type Config struct {
+	TcbEnv    string `yaml:"tcb_env"`
+	AppID     string `yaml:"app_id"`
+	AppSecret string `yaml:"app_secret"`
+}
+
+var cfg *Config
+var _ = getConfig()
+
+//通过getConfig方法获取配置参数
+func getConfig() *Config {
+	if cfg != nil {
+		return cfg
+	}
+	data, err := ioutil.ReadFile("./config.yaml")
+	if err != nil {
+		panic(err)
+	}
+	cfg = &Config{}
+	err = yaml.Unmarshal(data, cfg)
+	if err != nil {
+		panic(err)
+	}
+	return cfg
+}
+
+var wechatTcb *tcb.Tcb
+var _ = getTcb()
+//通过getTcb获取wechat sdk的配置参数
+func getTcb() *tcb.Tcb {
+	if wechatTcb != nil {
+		return wechatTcb
+	}
+	memCache := cache.NewMemory()
+
+	//配置小程序参数
+	config := &wechat.Config{
+		AppID:     getConfig().AppID,
+		AppSecret: getConfig().AppSecret,
+		Cache:     memCache,
+	}
+	wc := wechat.NewWechat(config)
+	wechatTcb = wc.GetTcb()
+	return wechatTcb
+}
+```
+
+其中config.yaml写入三个配置参数：
+
+```yaml
+tcb_env: test-6ku2s //云开发环境
+app_id: xxxxxx //云开发appid
+app_secret: xxxxxxxxx //云开发对应的app secret
+```
+
+<a name="VbDg9"></a>
+### 调用API
+为了方便在其他方法中方便调用sdk中的方法，这里新建一个 `feedbackService` struct，创建对应的save方法用于保存留言, `feedback.go` :
+
+```go
+package main
+
+import (
+	"fmt"
+	"time"
+)
+
+//FeedbackService service
+type FeedbackService struct {
+}
+
+//NewFeedbackService new
+func NewFeedbackService() *FeedbackService {
+	return &FeedbackService{}
+}
+
+//Feedback 留言记录
+type Feedback struct {
+	Username   string `form:"username",json:"username"`
+	Content    string `form:"content",json:"content"`
+	FilePath   string `json:"filePath"`//文件路径
+	FileID     string `json:"fileId"` //存放文件
+	CreateTime string `json:"createTime"`
+}
+
+func (svc *FeedbackService) Save(feedback *Feedback) error {
+	if feedback.Username == "" || feedback.Content == "" {
+		return fmt.Errorf("用户名或留言内容不能为空")
+	}
+	query := `db.collection(\"%s\").add({
+      data: [{
+        username: \"%s\",
+        content: \"%s\",
+		filePath: \"%s\",
+		fileId: \"%s\",
+        createTime: \"%s\",
+      }]
+      })`
+	feedback.CreateTime = time.Now().Format("2006-01-02 15:04:05")
+	query = fmt.Sprintf(query, "guestbook", feedback.Username, feedback.Content, feedback.FilePath, feedback.FileID, feedback.CreateTime)
+	_, err := getTcb().DatabaseAdd(getConfig().TcbEnv, query)
+	if err != nil {
+		return err
+	}
+	return nil
+}
+```
+
+其中对于数据库中的query语句可以参考[https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/database/add.html](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/database/add.html)
+
+这里调用 `DatabaseAdd` 方法实现内容的保存。
+
+<a name="8db0f827"></a>
+## 接收表单提交内容
+将表单提交的内容提交到 `/feedback` 路由中，并创建 `feedback`方法接收表单提交的参数，
+
+```go
+func main() {
+	r := gin.Default()
+
+	//包含html模板
+	r.LoadHTMLGlob("./template/*")
+	//渲染留言页面
+	r.GET("/",index)
+	//提交留言
+	r.POST("/feedback", feedback)
+
+	r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
+}
+```
+
+其中feedback方法如下：
+
+```go
+//接收提交的内容
+func feedback(c *gin.Context) {
+	//1、接收提交参数
+	feedback := &Feedback{}
+	err := c.Bind(feedback)
+	if err != nil {
+		showError(c, err)
+		return
+	}
+	feedbackService := NewFeedbackService()
+	//保存内容
+	err = feedbackService.Save(feedback)
+	if err != nil {
+		showError(c, err)
+		return
+	}
+
+	c.Redirect(http.StatusMovedPermanently, "/")
+}
+```
+
+这里通过c.Bind方法将form表单中的内容绑定到 `Feedback` stuct中，再通过调用feedbackService中的Save方法对文本内容进行保存。
+<a name="DlBj4"></a>
+## 展示留言内容
+留言内容的展示主要分为两步，一先从数据库展示出来，二是将留言内容展示在页面：<br />查询的sql语句为：
+```go
+db.collection("guestbook").orderBy('createTime','desc').skip(0).limit(10).get()
+```
+
+在 `feedback.go` 中新增List方法，其中参数传入skip和limit参数用于分页
+
+```go
+//List 文本列表
+func (svc *FeedbackService) List(skip, limit int) ([]*Feedback, error) {
+	query := fmt.Sprintf("db.collection(\"guestbook\").orderBy('createTime','desc').skip(%d).limit(%d).get()", skip, limit)
+	data, err := getTcb().DatabaseQuery(getConfig().TcbEnv, query)
+	if err != nil {
+		return nil, err
+	}
+	feedbacks := make([]*Feedback, 0, len(data.Data))
+	for _, v := range data.Data {
+		feedbackItem := &Feedback{}
+		err := json.Unmarshal([]byte(v), feedbackItem)
+		if err != nil {
+			return nil, err
+		}
+		feedbacks = append(feedbacks, feedbackItem)
+
+	}
+	//fmt.Println(data.Pager)
+	return feedbacks, nil
+}
+```
+
+这里主要调用 `DatabaseQuery` 方法对db进行查询。
+
+在main.go中的index方法在从数据中获取的数据取出并渲染在index.html中：
+
+```go
+//首页
+func index(c *gin.Context) {
+	page := c.Query("page")
+	//获取记录数量
+	feedbackService := NewFeedbackService()
+	count, err := feedbackService.Count()
+	if err != nil {
+		showError(c, err)
+		return
+	}
+	limit := 10
+	totalPage := math.Ceil(float64(count) / float64(limit))
+	totalPageInt := int(totalPage)
+	pageInt, _ := strconv.Atoi(page)
+	if pageInt > totalPageInt {
+		pageInt = totalPageInt
+	}
+	if pageInt < 1 {
+		pageInt = 1
+	}
+
+	//展示留言列表
+	skip := (pageInt - 1) * limit
+	list, err := feedbackService.List(skip, limit)
+	if err != nil {
+		showError(c, err)
+		return
+	}
+
+	c.HTML(http.StatusOK, "index.html", gin.H{
+		"title":     "留言板",
+		"list":      list,
+		"prevPage":  pageInt - 1,
+		"nextPage":  pageInt + 1,
+		"page":      pageInt,
+		"totalPage": totalPageInt,
+	})
+}
+```
+
+其中index.html通过go template语法对内容进行渲染
+
+```html
+    <div class="list-group list-group-flush">
+        {{range .list}}
+        <div class="list-group-item">
+            <div><span><b>{{.Username}} 在 {{.CreateTime}} 说：</b></span></div>
+            <div><p>{{.Content}}</p></div>
+        </div>
+        {{end}}
+    </div>
+    <div>
+        <span>第{{.page}}页</span>
+        {{if gt .page 1}}<a href="/?page={{.prevPage}}">上一页</a>{{end}}
+       {{if lt .page .totalPage}} <a href="/?page={{.nextPage}}">下一页</a>{{end}}
+    </div>
+```
+
+这样就实现了对文本内容的保存
+

cloudbase/guestbook-demo/start.md

@@ -0,0 +1,185 @@
+# 起步：项目搭建
+
+<a name="8MeIi"></a>
+## 目标
+通过完成一个留言板应用来熟悉云开发中go sdk中的使用，主要分为以下三个内容
+
+1. 如何利用云开发中的[数据库](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/database/#%E6%95%B0%E6%8D%AE%E5%BA%93)进行留言内容的保存
+1. 使用[云函数](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/functions/)进行文本内容的过滤
+1. 使用[云开发存储](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/storage/)能力进行附件的保存
+
+<a name="Nq75E"></a>
+## 环境介绍
+<a name="Kxmk0"></a>
+### Golang 1.13
+项目中使用Golang 1.13版本进行开发，并且使用go module 进行依赖管理
+<a name="H0cFe"></a>
+### 编辑器：Goland
+代码编辑工具
+<a name="PsxLG"></a>
+### 热编译工具：Gowatch
+Go 程序热编译工具，提升开发效率<br />官网地址： [https://github.com/silenceper/gowatch](https://github.com/silenceper/gowatch)<br />**快速安装：**
+```basic
+go get -u github.com/silenceper/gowatch
+```
+
+<a name="tNyRl"></a>
+### web开发框架-Gin
+一个web开发框架，方便快速构建一个web应用<br />官网： [https://github.com/gin-gonic/gin](https://github.com/gin-gonic/gin)
+<a name="MzLXD"></a>
+### Wechat SDK For Go
+使用Golang对微信公众号，小程序，云开发等API进行封装，使得Go项目中可以方便上手<br />官网： [https://github.com/silenceper/wechat/](https://github.com/silenceper/wechat/) <br />文档：[https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc)
+<a name="pNPPj"></a>
+### 云开发
+集成数据库，存储，云函数等功能的平台<br />使用文档：[https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-http-api/](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-http-api/)<br />在开始开发前，请注册一个小程序获取 `app_id` , `app_secret`参数，并开启云开发功能。
+
+<a name="qyAfI"></a>
+## 初始化项目
+> 本项目中使用go module进行依赖管理
+
+在工作目录创建一个项目`guestbook`，并使用`go mod init github.com/go-demo/guestbook`进行初始化，后面接的是`import path`。
+
+```bash
+mkdir guestbook
+cd guestbook
+go mod init github.com/go-demo/guestbook
+```
+
+<a name="JvK7M"></a>
+### 编写main.go文件
+使用goland编辑器中打开这个项目，并创建一个`main.go`文件，内容如下：
+
+```go
+package main
+
+import "github.com/gin-gonic/gin"
+
+func main() {
+	r := gin.Default()
+	r.GET("/ping", func(c *gin.Context) {
+		c.JSON(200, gin.H{
+			"message": "pong",
+		})
+	})
+	r.Run() // listen and serve on 0.0.0.0:8080
+}
+```
+
+<a name="q2Vtn"></a>
+### 编译并运行
+我们可以在Goland编辑器中Terminal面板中进入项目目录，使用`gowatch`命令对该项目进行热编译，看到图片中的log输出表示已经启动成功：
+> gowatch会监听项目中文件的变化，当进行变化后，对项目进行build 和run，这样我们就可以在一边修改代码一边对项目进行编译及时发现错误，是不是效率提升了呢  :>
+
+
+![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1579680949745-4a9d705e-b2d1-4667-a7a7-b9a5200321c8.png#align=left&display=inline&height=777&name=image.png&originHeight=1554&originWidth=2470&size=400945&status=done&style=none&width=1235)<br />（初次build会通过go module自动下载依赖，请注意开启go module功能）
+
+我们通过访问`127.0.0.1:8080/ping`就可以看到页面上输出`{"message":"pong"}`说明服务启动成功。
+
+<a name="yXtGW"></a>
+## 渲染留言页面
+我们可以先规划我们的UI是怎么样子？
+
+包含两部分：
+
+- 留言框：包含留言内容，附件上传，用户名，提交按钮
+- 内容展示：展示留言内容，附件以及留言者和留言日期
+
+界面展示如下：<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1579681903215-81a613c0-0a08-4196-ba6d-36c8942e107c.png#align=left&display=inline&height=331&name=image.png&originHeight=1312&originWidth=2352&size=99758&status=done&style=none&width=593)
+<a name="2vKHj"></a>
+### 创建模板文件
+对应的html代码如下，我们保存在项目中的template/index.html文件中：
+
+```html
+<!doctype html>
+<html>
+<head>
+    <title>留言板</title>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.4.1/dist/css/bootstrap.min.css"
+          integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
+</head>
+<body class="container-md">
+<h3>留言板</h3>
+<div>
+    <form action="/feedback" method="post" enctype="multipart/form-data">
+        <div class="form-group">
+            <textarea class="form-control" name="content" id="content" cols="50" rows="5"></textarea>
+        </div>
+        <div class="form-group">
+            <label for="file">附件</label>
+            <input type="file" class="form-control-file" name="file" id="">
+        </div>
+        <div class="form-group">
+            <label for="username">名字</label>
+            <input type="text" name="username" class="form-control"></div>
+        <div class="form-group"><input type="submit" value="提交" class="btn btn-primary"></div>
+    </form>
+    <h2>内容</h2>
+    <div class="list-group list-group-flush">
+            <div class="list-group-item">
+                <div><span><b>silenceper 在 2020-01-21 12:33:45 说：</b></span></div>
+                <div><p>留言板内容</p></div>
+            </div>
+    </div>
+    <div>
+        <span>第1页</span>
+    </div>
+</div>
+</body>
+</html>
+```
+
+这里引入了bootstrap样式文件，不需要自己写太多前端样式了，出来的UI也不会太难看。
+
+<a name="MLcML"></a>
+### 通过gin渲染模板
+我们想要通过访问`127.0.0.1:8080`直接访问到这个留言页面，main.go中代码如下：
+
+```go
+package main
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+func main() {
+	r := gin.Default()
+
+	//包含html模板
+	r.LoadHTMLGlob("./template/*")
+	//渲染留言页面,GET请求，通过根路径可以直接访问
+    //当路径匹配成功后，进入index访问进行处理
+	r.GET("/",index)
+
+
+	r.Run() // listen and serve on 0.0.0.0:8080
+}
+
+//渲染留言板首页
+func index(c *gin.Context) {
+    //返回200，并渲染index.html页面
+	c.HTML(http.StatusOK,"index.html",gin.H{
+		"title":"留言板",
+	})
+}
+```
+
+其中`r.LoadHTMLGlob("./template/*") `指定了html模板的位置，这样在使用进行`c.HTML`进行渲染的时候就知道到哪个位置进行查找了。
+
+**c.HTML说明：**
+
+- 第一个参数：http状态码
+- 第二个参数：需要渲染的模板
+- 第三个参数：需要传递的值（`gin.H`其实是一个`map[string]interface{}`的别名）
+
+这里`c.HTML`渲染了`index.html`，并以`200`状态码输出，第三个参数`gin.H`，传入`key:value` ,就可以在`index.html`页面中使用go-template语法进行值的替换，语法格式：
+
+`{{.title}}`
+
+这里可以查阅gin文档：[如何进行html渲染](https://github.com/gin-gonic/gin#html-rendering)
+
+<a name="XXc0s"></a>
+## 代码地址
+本文中所有代码都上传在 [https://github.com/go-demo/guestbook](https://github.com/go-demo/guestbook)
+

cloudbase/guestbook-demo/storage.md

@@ -0,0 +1,144 @@
+# 云开发存储：实现留言本附件上传
+## API说明
+官方文档：[微信云开发存储文档](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/storage/)，主要提供了三个API(上传，下载，删除)，可以先分别看下参数
+
+在这一节中主要利用到了sdk中的附件上传和下载的方法，方法如下：
+```go
+func (tcb *Tcb) UploadFile(env, path string) (*UploadFileRes, error) {
+func (tcb *Tcb) BatchDownloadFile(env string, fileList []*DownloadFile) (*BatchDownloadFileRes, error) {
+```
+
+返回对应的返回结果在这里可以查看，[UploadFileRes](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#UploadFileRes)，[BatchDownloadFileRes](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#BatchDownloadFileRes)
+
+<a name="264b81c5"></a>
+## 接收附件上传内容
+1、保存index.html中form表单中使用的是post方法并且enctype为 `multipart/form-data` :
+
+```html
+    <form action="/feedback" method="post" enctype="multipart/form-data">
+```
+2、在main.go中的feedback方法中获取上传的文件
+
+```go
+//2、文件上传
+	fileHeader, err := c.FormFile("file")
+	if err != nil && err != http.ErrMissingFile {
+		showError(c, err)
+		return
+	}
+```
+
+<a name="186268da"></a>
+## 将附件保存在云开发中
+在feedbackService中创建 `UploadFile` 方法，调用sdk中文件上传方法实现对文件的上传：<br />UploadFile 第一个参数为云开发环境，第二个参数为需要附件需要保存的路径
+> 注意，这里path应该为相对路径。不能为绝对路径比如 /guestbook 应该为 guestbook 否则会报错。
+
+
+```go
+
+//UploadFile 上传文件
+func (svc *FeedbackService) UploadFile(path string, file io.Reader) (string, error) {
+	//获取文件上传链接
+	uploadRes, err := getTcb().UploadFile(getConfig().TcbEnv, path)
+	if err != nil {
+		return "", err
+	}
+
+	data := make(map[string]io.Reader)
+	data["key"] = strings.NewReader(path)
+	data["Signature"] = strings.NewReader(uploadRes.Authorization)
+	data["x-cos-security-token"] = strings.NewReader(uploadRes.Token)
+	data["x-cos-meta-fileid"] = strings.NewReader(uploadRes.CosFileID)
+	data["file"] = file
+
+	//上传文件
+	_, err = goutils.PostFormWithFile(&http.Client{}, uploadRes.URL, data)
+	return uploadRes.FileID, err
+}
+```
+
+其中 `PostFormWithFile` 方法是对 `mime/multipart` 方法的一个封装，用于将附件内容上传到指定的url中，在 `github.com/silenceper/goutils` 包中。
+
+并在main.go中feedback方法调用并将返回的field和Filename保存在db中
+
+```go
+	//2、文件上传
+	fileHeader, err := c.FormFile("file")
+	if err != nil && err != http.ErrMissingFile {
+		showError(c, err)
+		return
+	}
+	feedbackService := NewFeedbackService()
+	if fileHeader != nil {
+		path := fmt.Sprintf("guestbook/%s", fileHeader.Filename)
+		file, err := fileHeader.Open()
+		if err != nil {
+			showError(c, err)
+			return
+		}
+
+		fileID, err := feedbackService.UploadFile(path, file)
+		if err != nil {
+			showError(c, err)
+			return
+		}
+		feedback.FilePath = fileHeader.Filename
+		feedback.FileID = fileID
+	}
+```
+
+最终附件可以在index方法通过数据库查询在html中展示出来
+
+<a name="786a132e"></a>
+## 附件下载
+这里创建一个单独的路由，用于对附件进行下载，通过在get参数中传入fileId，定位到附件，并打开附件路径：
+
+```go
+	r.GET("/file", downloadFile)
+```
+
+```go
+//附件下载
+func downloadFile(c *gin.Context) {
+	fileID := c.Query("id")
+	if fileID == "" {
+		showError(c, fmt.Errorf("fileID为空"))
+		return
+	}
+	downLoadURL, err := NewFeedbackService().DownloadFile(fileID)
+	if err != nil {
+		showError(c, err)
+		return
+	}
+	c.Redirect(http.StatusMovedPermanently, downLoadURL)
+}
+```
+
+在feedbackService中创建DownloadFile方法，返回真实下载路径，并跳转:
+
+```go
+
+//DownloadFile 获取下载链接
+func (svc *FeedbackService) DownloadFile(id string) (string, error) {
+	files := []*tcb.DownloadFile{&tcb.DownloadFile{
+		FileID: id,
+		MaxAge: 100,
+	}}
+	res, err := getTcb().BatchDownloadFile(getConfig().TcbEnv, files)
+	if err != nil {
+		return "", err
+	}
+	if len(res.FileList) >= 1 {
+		return res.FileList[0].DownloadURL, nil
+	}
+	return "", nil
+}
+```
+
+这里BatchDownloadFile方法第一个参数是云开发环境，第二个参数接收的 `tcb.DownloadFile` 数组，指定fileID和下载链接的有效期。
+
+最终完成的效果如下：<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1580025839031-8efea9fe-3ce0-4a4b-a8cd-0ad2120c1a9e.png#align=left&display=inline&height=666&name=image.png&originHeight=1332&originWidth=2256&size=112605&status=done&style=none&width=1128)
+
+
+本文中所有代码都上传在 [https://github.com/go-demo/guestbook](https://github.com/go-demo/guestbook)
+

context/access_token.go

@@ -0,0 +1,85 @@
+package context
+
+import (
+	"encoding/json"
+	"fmt"
+	"sync"
+	"time"
+
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	//AccessTokenURL 获取access_token的接口
+	AccessTokenURL = "https://api.weixin.qq.com/cgi-bin/token"
+)
+
+//ResAccessToken struct
+type ResAccessToken struct {
+	util.CommonError
+
+	AccessToken string `json:"access_token"`
+	ExpiresIn   int64  `json:"expires_in"`
+}
+
+//GetAccessTokenFunc 获取 access token 的函数签名
+type GetAccessTokenFunc func(ctx *Context) (accessToken string, err error)
+
+//SetAccessTokenLock 设置读写锁（一个appID一个读写锁）
+func (ctx *Context) SetAccessTokenLock(l *sync.RWMutex) {
+	ctx.accessTokenLock = l
+}
+
+//SetGetAccessTokenFunc 设置自定义获取accessToken的方式, 需要自己实现缓存
+func (ctx *Context) SetGetAccessTokenFunc(f GetAccessTokenFunc) {
+	ctx.accessTokenFunc = f
+}
+
+//GetAccessToken 获取access_token
+func (ctx *Context) GetAccessToken() (accessToken string, err error) {
+	ctx.accessTokenLock.Lock()
+	defer ctx.accessTokenLock.Unlock()
+
+	if ctx.accessTokenFunc != nil {
+		return ctx.accessTokenFunc(ctx)
+	}
+	accessTokenCacheKey := fmt.Sprintf("access_token_%s", ctx.AppID)
+	val := ctx.Cache.Get(accessTokenCacheKey)
+	if val != nil {
+		accessToken = val.(string)
+		return
+	}
+
+	//从微信服务器获取
+	var resAccessToken ResAccessToken
+	resAccessToken, err = ctx.GetAccessTokenFromServer()
+	if err != nil {
+		return
+	}
+
+	accessToken = resAccessToken.AccessToken
+	return
+}
+
+//GetAccessTokenFromServer 强制从微信服务器获取token
+func (ctx *Context) GetAccessTokenFromServer() (resAccessToken ResAccessToken, err error) {
+	url := fmt.Sprintf("%s?grant_type=client_credential&appid=%s&secret=%s", AccessTokenURL, ctx.AppID, ctx.AppSecret)
+	var body []byte
+	body, err = util.HTTPGet(url)
+	if err != nil {
+		return
+	}
+	err = json.Unmarshal(body, &resAccessToken)
+	if err != nil {
+		return
+	}
+	if resAccessToken.ErrMsg != "" {
+		err = fmt.Errorf("get access_token error : errcode=%v , errormsg=%v", resAccessToken.ErrCode, resAccessToken.ErrMsg)
+		return
+	}
+
+	accessTokenCacheKey := fmt.Sprintf("access_token_%s", ctx.AppID)
+	expires := resAccessToken.ExpiresIn - 1500
+	err = ctx.Cache.Set(accessTokenCacheKey, resAccessToken.AccessToken, time.Duration(expires)*time.Second)
+	return
+}

context/access_token_test.go

@@ -0,0 +1,30 @@
+package context
+
+import (
+	"sync"
+	"testing"
+)
+
+func TestContext_SetCustomAccessTokenFunc(t *testing.T) {
+	ctx := Context{
+		accessTokenLock: new(sync.RWMutex),
+	}
+	f := func(ctx *Context) (accessToken string, err error) {
+		return "fake token", nil
+	}
+	ctx.SetGetAccessTokenFunc(f)
+	res, err := ctx.GetAccessToken()
+	if res != "fake token" || err != nil {
+		t.Error("expect fake token but error")
+	}
+}
+
+func TestContext_NoSetCustomAccessTokenFunc(t *testing.T) {
+	ctx := Context{
+		accessTokenLock: new(sync.RWMutex),
+	}
+
+	if ctx.accessTokenFunc != nil {
+		t.Error("error accessTokenFunc")
+	}
+}

context/component_access_token.go

@@ -0,0 +1,221 @@
+package context
+
+import (
+	"encoding/json"
+	"fmt"
+	"time"
+
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	componentAccessTokenURL = "https://api.weixin.qq.com/cgi-bin/component/api_component_token"
+	getPreCodeURL           = "https://api.weixin.qq.com/cgi-bin/component/api_create_preauthcode?component_access_token=%s"
+	queryAuthURL            = "https://api.weixin.qq.com/cgi-bin/component/api_query_auth?component_access_token=%s"
+	refreshTokenURL         = "https://api.weixin.qq.com/cgi-bin/component/api_authorizer_token?component_access_token=%s"
+	getComponentInfoURL     = "https://api.weixin.qq.com/cgi-bin/component/api_get_authorizer_info?component_access_token=%s"
+	getComponentConfigURL   = "https://api.weixin.qq.com/cgi-bin/component/api_get_authorizer_option?component_access_token=%s"
+)
+
+// ComponentAccessToken 第三方平台
+type ComponentAccessToken struct {
+	AccessToken string `json:"component_access_token"`
+	ExpiresIn   int64  `json:"expires_in"`
+}
+
+// GetComponentAccessToken 获取 ComponentAccessToken
+func (ctx *Context) GetComponentAccessToken() (string, error) {
+	accessTokenCacheKey := fmt.Sprintf("component_access_token_%s", ctx.AppID)
+	val := ctx.Cache.Get(accessTokenCacheKey)
+	if val == nil {
+		return "", fmt.Errorf("cann't get component access token")
+	}
+	return val.(string), nil
+}
+
+// SetComponentAccessToken 通过component_verify_ticket 获取 ComponentAccessToken
+func (ctx *Context) SetComponentAccessToken(verifyTicket string) (*ComponentAccessToken, error) {
+	body := map[string]string{
+		"component_appid":         ctx.AppID,
+		"component_appsecret":     ctx.AppSecret,
+		"component_verify_ticket": verifyTicket,
+	}
+	respBody, err := util.PostJSON(componentAccessTokenURL, body)
+	if err != nil {
+		return nil, err
+	}
+
+	at := &ComponentAccessToken{}
+	if err := json.Unmarshal(respBody, at); err != nil {
+		return nil, err
+	}
+
+	accessTokenCacheKey := fmt.Sprintf("component_access_token_%s", ctx.AppID)
+	expires := at.ExpiresIn - 1500
+	ctx.Cache.Set(accessTokenCacheKey, at.AccessToken, time.Duration(expires)*time.Second)
+	return at, nil
+}
+
+// GetPreCode 获取预授权码
+func (ctx *Context) GetPreCode() (string, error) {
+	cat, err := ctx.GetComponentAccessToken()
+	if err != nil {
+		return "", err
+	}
+	req := map[string]string{
+		"component_appid": ctx.AppID,
+	}
+	uri := fmt.Sprintf(getPreCodeURL, cat)
+	body, err := util.PostJSON(uri, req)
+	if err != nil {
+		return "", err
+	}
+
+	var ret struct {
+		PreCode string `json:"pre_auth_code"`
+	}
+	if err := json.Unmarshal(body, &ret); err != nil {
+		return "", err
+	}
+
+	return ret.PreCode, nil
+}
+
+// ID 微信返回接口中各种类型字段
+type ID struct {
+	ID int `json:"id"`
+}
+
+// AuthBaseInfo 授权的基本信息
+type AuthBaseInfo struct {
+	AuthrAccessToken
+	FuncInfo []AuthFuncInfo `json:"func_info"`
+}
+
+// AuthFuncInfo 授权的接口内容
+type AuthFuncInfo struct {
+	FuncscopeCategory ID `json:"funcscope_category"`
+}
+
+// AuthrAccessToken 授权方AccessToken
+type AuthrAccessToken struct {
+	Appid        string `json:"authorizer_appid"`
+	AccessToken  string `json:"authorizer_access_token"`
+	ExpiresIn    int64  `json:"expires_in"`
+	RefreshToken string `json:"authorizer_refresh_token"`
+}
+
+// QueryAuthCode 使用授权码换取公众号或小程序的接口调用凭据和授权信息
+func (ctx *Context) QueryAuthCode(authCode string) (*AuthBaseInfo, error) {
+	cat, err := ctx.GetComponentAccessToken()
+	if err != nil {
+		return nil, err
+	}
+
+	req := map[string]string{
+		"component_appid":    ctx.AppID,
+		"authorization_code": authCode,
+	}
+	uri := fmt.Sprintf(queryAuthURL, cat)
+	body, err := util.PostJSON(uri, req)
+	if err != nil {
+		return nil, err
+	}
+
+	var ret struct {
+		Info *AuthBaseInfo `json:"authorization_info"`
+	}
+
+	if err := json.Unmarshal(body, &ret); err != nil {
+		return nil, err
+	}
+
+	return ret.Info, nil
+}
+
+// RefreshAuthrToken 获取（刷新）授权公众号或小程序的接口调用凭据（令牌）
+func (ctx *Context) RefreshAuthrToken(appid, refreshToken string) (*AuthrAccessToken, error) {
+	cat, err := ctx.GetComponentAccessToken()
+	if err != nil {
+		return nil, err
+	}
+
+	req := map[string]string{
+		"component_appid":          ctx.AppID,
+		"authorizer_appid":         appid,
+		"authorizer_refresh_token": refreshToken,
+	}
+	uri := fmt.Sprintf(refreshTokenURL, cat)
+	body, err := util.PostJSON(uri, req)
+	if err != nil {
+		return nil, err
+	}
+
+	ret := &AuthrAccessToken{}
+	if err := json.Unmarshal(body, ret); err != nil {
+		return nil, err
+	}
+
+	authrTokenKey := "authorizer_access_token_" + appid
+	ctx.Cache.Set(authrTokenKey, ret.AccessToken, time.Minute*80)
+
+	return ret, nil
+}
+
+// GetAuthrAccessToken 获取授权方AccessToken
+func (ctx *Context) GetAuthrAccessToken(appid string) (string, error) {
+	authrTokenKey := "authorizer_access_token_" + appid
+	val := ctx.Cache.Get(authrTokenKey)
+	if val == nil {
+		return "", fmt.Errorf("cannot get authorizer %s access token", appid)
+	}
+	return val.(string), nil
+}
+
+// AuthorizerInfo 授权方详细信息
+type AuthorizerInfo struct {
+	NickName        string `json:"nick_name"`
+	HeadImg         string `json:"head_img"`
+	ServiceTypeInfo ID     `json:"service_type_info"`
+	VerifyTypeInfo  ID     `json:"verify_type_info"`
+	UserName        string `json:"user_name"`
+	PrincipalName   string `json:"principal_name"`
+	BusinessInfo    struct {
+		OpenStore string `json:"open_store"`
+		OpenScan  string `json:"open_scan"`
+		OpenPay   string `json:"open_pay"`
+		OpenCard  string `json:"open_card"`
+		OpenShake string `json:"open_shake"`
+	}
+	Alias     string `json:"alias"`
+	QrcodeURL string `json:"qrcode_url"`
+}
+
+// GetAuthrInfo 获取授权方的帐号基本信息
+func (ctx *Context) GetAuthrInfo(appid string) (*AuthorizerInfo, *AuthBaseInfo, error) {
+	cat, err := ctx.GetComponentAccessToken()
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req := map[string]string{
+		"component_appid":  ctx.AppID,
+		"authorizer_appid": appid,
+	}
+
+	uri := fmt.Sprintf(getComponentInfoURL, cat)
+	body, err := util.PostJSON(uri, req)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var ret struct {
+		AuthorizerInfo    *AuthorizerInfo `json:"authorizer_info"`
+		AuthorizationInfo *AuthBaseInfo   `json:"authorization_info"`
+	}
+	if err := json.Unmarshal(body, &ret); err != nil {
+		return nil, nil, err
+	}
+
+	return ret.AuthorizerInfo, ret.AuthorizationInfo, nil
+}

context/component_test.go

@@ -0,0 +1,19 @@
+package context
+
+import (
+	"encoding/json"
+	"testing"
+)
+
+var testdata = `{"authorizer_info":{"nick_name":"就爱浪","head_img":"http:\/\/wx.qlogo.cn\/mmopen\/xPKCxELaaj6hiaTZGv19oQPBJibb7hBoKmNOjQibCNOUycE8iaBhiaHOA6eC8hadQSAUZTuHUJl4qCIbCQGjSWialicfzWh4mdxuejY\/0","service_type_info":{"id":1},"verify_type_info":{"id":-1},"user_name":"gh_dcdbaa6f1687","alias":"ckeyer","qrcode_url":"http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/FribWCoIzQbAX7R1PQ8iaxGonqKp0doYD2ibhC0uhx11LrRcblASiazsbQJTJ4icQnMzfH7G0SUPuKbibTA8Cs4uk5WQ\/0","business_info":{"open_pay":0,"open_shake":0,"open_scan":0,"open_card":0,"open_store":0},"idc":1,"principal_name":"个人","signature":"不折腾会死。"},"authorization_info":{"authorizer_appid":"yyyyy","authorizer_refresh_token":"xxxx","func_info":[{"funcscope_category":{"id":1}},{"funcscope_category":{"id":15}},{"funcscope_category":{"id":4}},{"funcscope_category":{"id":7}},{"funcscope_category":{"id":2}},{"funcscope_category":{"id":3}},{"funcscope_category":{"id":11}},{"funcscope_category":{"id":6}},{"funcscope_category":{"id":5}},{"funcscope_category":{"id":8}},{"funcscope_category":{"id":13}},{"funcscope_category":{"id":9}},{"funcscope_category":{"id":12}},{"funcscope_category":{"id":22}},{"funcscope_category":{"id":23}},{"funcscope_category":{"id":24},"confirm_info":{"need_confirm":0,"already_confirm":0,"can_confirm":0}},{"funcscope_category":{"id":26}},{"funcscope_category":{"id":27},"confirm_info":{"need_confirm":0,"already_confirm":0,"can_confirm":0}},{"funcscope_category":{"id":33},"confirm_info":{"need_confirm":0,"already_confirm":0,"can_confirm":0}},{"funcscope_category":{"id":35}}]}}`
+
+// TestDecode
+func TestDecode(t *testing.T) {
+	var ret struct {
+		AuthorizerInfo    *AuthorizerInfo `json:"authorizer_info"`
+		AuthorizationInfo *AuthBaseInfo   `json:"authorization_info"`
+	}
+	json.Unmarshal([]byte(testdata), &ret)
+	t.Logf("%+v", ret.AuthorizerInfo)
+	t.Logf("%+v", ret.AuthorizationInfo)
+}

context/context.go

@@ -0,0 +1,58 @@
+package context
+
+import (
+	"net/http"
+	"sync"
+
+	"github.com/silenceper/wechat/cache"
+)
+
+// Context struct
+type Context struct {
+	AppID          string
+	AppSecret      string
+	Token          string
+	EncodingAESKey string
+	PayMchID       string
+	PayNotifyURL   string
+	PayKey         string
+
+	Cache cache.Cache
+
+	Writer  http.ResponseWriter
+	Request *http.Request
+
+	//accessTokenLock 读写锁 同一个AppID一个
+	accessTokenLock *sync.RWMutex
+
+	//jsAPITicket 读写锁 同一个AppID一个
+	jsAPITicketLock *sync.RWMutex
+
+	//accessTokenFunc 自定义获取 access token 的方法
+	accessTokenFunc GetAccessTokenFunc
+}
+
+// Query returns the keyed url query value if it exists
+func (ctx *Context) Query(key string) string {
+	value, _ := ctx.GetQuery(key)
+	return value
+}
+
+// GetQuery is like Query(), it returns the keyed url query value
+func (ctx *Context) GetQuery(key string) (string, bool) {
+	req := ctx.Request
+	if values, ok := req.URL.Query()[key]; ok && len(values) > 0 {
+		return values[0], true
+	}
+	return "", false
+}
+
+// SetJsAPITicketLock 设置jsAPITicket的lock
+func (ctx *Context) SetJsAPITicketLock(lock *sync.RWMutex) {
+	ctx.jsAPITicketLock = lock
+}
+
+// GetJsAPITicketLock 获取jsAPITicket 的lock
+func (ctx *Context) GetJsAPITicketLock() *sync.RWMutex {
+	return ctx.jsAPITicketLock
+}

context/qy_access_token.go

@@ -0,0 +1,76 @@
+package context
+
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+	"sync"
+	"time"
+
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	//qyAccessTokenURL 获取access_token的接口
+	qyAccessTokenURL = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=%s&corpsecret=%s"
+)
+
+//ResQyAccessToken struct
+type ResQyAccessToken struct {
+	util.CommonError
+
+	AccessToken string `json:"access_token"`
+	ExpiresIn   int64  `json:"expires_in"`
+}
+
+//SetQyAccessTokenLock 设置读写锁（一个appID一个读写锁）
+func (ctx *Context) SetQyAccessTokenLock(l *sync.RWMutex) {
+	ctx.accessTokenLock = l
+}
+
+//GetQyAccessToken 获取access_token
+func (ctx *Context) GetQyAccessToken() (accessToken string, err error) {
+	ctx.accessTokenLock.Lock()
+	defer ctx.accessTokenLock.Unlock()
+
+	accessTokenCacheKey := fmt.Sprintf("qy_access_token_%s", ctx.AppID)
+	val := ctx.Cache.Get(accessTokenCacheKey)
+	if val != nil {
+		accessToken = val.(string)
+		return
+	}
+
+	//从微信服务器获取
+	var resQyAccessToken ResQyAccessToken
+	resQyAccessToken, err = ctx.GetQyAccessTokenFromServer()
+	if err != nil {
+		return
+	}
+
+	accessToken = resQyAccessToken.AccessToken
+	return
+}
+
+//GetQyAccessTokenFromServer 强制从微信服务器获取token
+func (ctx *Context) GetQyAccessTokenFromServer() (resQyAccessToken ResQyAccessToken, err error) {
+	log.Printf("GetQyAccessTokenFromServer")
+	url := fmt.Sprintf(qyAccessTokenURL, ctx.AppID, ctx.AppSecret)
+	var body []byte
+	body, err = util.HTTPGet(url)
+	if err != nil {
+		return
+	}
+	err = json.Unmarshal(body, &resQyAccessToken)
+	if err != nil {
+		return
+	}
+	if resQyAccessToken.ErrCode != 0 {
+		err = fmt.Errorf("get qy_access_token error : errcode=%v , errormsg=%v", resQyAccessToken.ErrCode, resQyAccessToken.ErrMsg)
+		return
+	}
+
+	qyAccessTokenCacheKey := fmt.Sprintf("qy_access_token_%s", ctx.AppID)
+	expires := resQyAccessToken.ExpiresIn - 1500
+	err = ctx.Cache.Set(qyAccessTokenCacheKey, resQyAccessToken.AccessToken, time.Duration(expires)*time.Second)
+	return
+}

context/render.go

@@ -0,0 +1,43 @@
+package context
+
+import (
+	"encoding/xml"
+	"net/http"
+)
+
+var xmlContentType = []string{"application/xml; charset=utf-8"}
+var plainContentType = []string{"text/plain; charset=utf-8"}
+
+//Render render from bytes
+func (ctx *Context) Render(bytes []byte) {
+	//debug
+	//fmt.Println("response msg = ", string(bytes))
+	ctx.Writer.WriteHeader(200)
+	_, err := ctx.Writer.Write(bytes)
+	if err != nil {
+		panic(err)
+	}
+}
+
+//String render from string
+func (ctx *Context) String(str string) {
+	writeContextType(ctx.Writer, plainContentType)
+	ctx.Render([]byte(str))
+}
+
+//XML render to xml
+func (ctx *Context) XML(obj interface{}) {
+	writeContextType(ctx.Writer, xmlContentType)
+	bytes, err := xml.Marshal(obj)
+	if err != nil {
+		panic(err)
+	}
+	ctx.Render(bytes)
+}
+
+func writeContextType(w http.ResponseWriter, value []string) {
+	header := w.Header()
+	if val := header["Content-Type"]; len(val) == 0 {
+		header["Content-Type"] = value
+	}
+}

credential/access_token.go

@@ -1,14 +0,0 @@
-package credential
-
-import "context"
-
-// AccessTokenHandle AccessToken 接口
-type AccessTokenHandle interface {
-	GetAccessToken() (accessToken string, err error)
-}
-
-// AccessTokenContextHandle AccessToken 接口
-type AccessTokenContextHandle interface {
-	AccessTokenHandle
-	GetAccessTokenContext(ctx context.Context) (accessToken string, err error)
-}

credential/default_access_token.go

@@ -1,248 +0,0 @@
-package credential
-
-import (
-	"context"
-	"encoding/json"
-	"fmt"
-	"sync"
-	"time"
-
-	"github.com/silenceper/wechat/v2/cache"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	// accessTokenURL 获取access_token的接口
-	accessTokenURL = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s"
-	// stableAccessTokenURL 获取稳定版access_token的接口
-	stableAccessTokenURL = "https://api.weixin.qq.com/cgi-bin/stable_token"
-	// workAccessTokenURL 企业微信获取access_token的接口
-	workAccessTokenURL = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=%s&corpsecret=%s"
-	// CacheKeyOfficialAccountPrefix 微信公众号cache key前缀
-	CacheKeyOfficialAccountPrefix = "gowechat_officialaccount_"
-	// CacheKeyMiniProgramPrefix 小程序cache key前缀
-	CacheKeyMiniProgramPrefix = "gowechat_miniprogram_"
-	// CacheKeyWorkPrefix 企业微信cache key前缀
-	CacheKeyWorkPrefix = "gowechat_work_"
-)
-
-// DefaultAccessToken 默认AccessToken 获取
-type DefaultAccessToken struct {
-	appID           string
-	appSecret       string
-	cacheKeyPrefix  string
-	cache           cache.Cache
-	accessTokenLock *sync.Mutex
-}
-
-// NewDefaultAccessToken new DefaultAccessToken
-func NewDefaultAccessToken(appID, appSecret, cacheKeyPrefix string, cache cache.Cache) AccessTokenContextHandle {
-	if cache == nil {
-		panic("cache is ineed")
-	}
-	return &DefaultAccessToken{
-		appID:           appID,
-		appSecret:       appSecret,
-		cache:           cache,
-		cacheKeyPrefix:  cacheKeyPrefix,
-		accessTokenLock: new(sync.Mutex),
-	}
-}
-
-// ResAccessToken struct
-type ResAccessToken struct {
-	util.CommonError
-
-	AccessToken string `json:"access_token"`
-	ExpiresIn   int64  `json:"expires_in"`
-}
-
-// GetAccessToken 获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *DefaultAccessToken) GetAccessToken() (accessToken string, err error) {
-	return ak.GetAccessTokenContext(context.Background())
-}
-
-// GetAccessTokenContext 获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *DefaultAccessToken) GetAccessTokenContext(ctx context.Context) (accessToken string, err error) {
-	// 先从cache中取
-	accessTokenCacheKey := fmt.Sprintf("%s_access_token_%s", ak.cacheKeyPrefix, ak.appID)
-
-	if val := ak.cache.Get(accessTokenCacheKey); val != nil {
-		if accessToken = val.(string); accessToken != "" {
-			return
-		}
-	}
-
-	// 加上lock，是为了防止在并发获取token时，cache刚好失效，导致从微信服务器上获取到不同token
-	ak.accessTokenLock.Lock()
-	defer ak.accessTokenLock.Unlock()
-
-	// 双检，防止重复从微信服务器获取
-	if val := ak.cache.Get(accessTokenCacheKey); val != nil {
-		if accessToken = val.(string); accessToken != "" {
-			return
-		}
-	}
-
-	// cache失效，从微信服务器获取
-	var resAccessToken ResAccessToken
-	if resAccessToken, err = GetTokenFromServerContext(ctx, fmt.Sprintf(accessTokenURL, ak.appID, ak.appSecret)); err != nil {
-		return
-	}
-
-	expires := resAccessToken.ExpiresIn - 1500
-	err = ak.cache.Set(accessTokenCacheKey, resAccessToken.AccessToken, time.Duration(expires)*time.Second)
-
-	accessToken = resAccessToken.AccessToken
-	return
-}
-
-// StableAccessToken 获取稳定版接口调用凭据(与getAccessToken获取的调用凭证完全隔离，互不影响)
-// 不强制更新access_token,可用于不同环境不同服务而不需要分布式锁以及公用缓存，避免access_token争抢
-// https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-access-token/getStableAccessToken.html
-type StableAccessToken struct {
-	appID          string
-	appSecret      string
-	cacheKeyPrefix string
-	cache          cache.Cache
-}
-
-// NewStableAccessToken new StableAccessToken
-func NewStableAccessToken(appID, appSecret, cacheKeyPrefix string, cache cache.Cache) AccessTokenContextHandle {
-	if cache == nil {
-		panic("cache is need")
-	}
-	return &StableAccessToken{
-		appID:          appID,
-		appSecret:      appSecret,
-		cache:          cache,
-		cacheKeyPrefix: cacheKeyPrefix,
-	}
-}
-
-// GetAccessToken 获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *StableAccessToken) GetAccessToken() (accessToken string, err error) {
-	return ak.GetAccessTokenContext(context.Background())
-}
-
-// GetAccessTokenContext 获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *StableAccessToken) GetAccessTokenContext(ctx context.Context) (accessToken string, err error) {
-	// 先从cache中取
-	accessTokenCacheKey := fmt.Sprintf("%s_stable_access_token_%s", ak.cacheKeyPrefix, ak.appID)
-	if val := ak.cache.Get(accessTokenCacheKey); val != nil {
-		return val.(string), nil
-	}
-
-	// cache失效，从微信服务器获取
-	var resAccessToken ResAccessToken
-	resAccessToken, err = ak.GetAccessTokenDirectly(ctx, false)
-	if err != nil {
-		return
-	}
-
-	expires := resAccessToken.ExpiresIn - 300
-	err = ak.cache.Set(accessTokenCacheKey, resAccessToken.AccessToken, time.Duration(expires)*time.Second)
-
-	accessToken = resAccessToken.AccessToken
-	return
-}
-
-// GetAccessTokenDirectly 从微信获取access_token
-func (ak *StableAccessToken) GetAccessTokenDirectly(ctx context.Context, forceRefresh bool) (resAccessToken ResAccessToken, err error) {
-	b, err := util.PostJSONContext(ctx, stableAccessTokenURL, map[string]interface{}{
-		"grant_type":    "client_credential",
-		"appid":         ak.appID,
-		"secret":        ak.appSecret,
-		"force_refresh": forceRefresh,
-	})
-	if err != nil {
-		return
-	}
-
-	if err = json.Unmarshal(b, &resAccessToken); err != nil {
-		return
-	}
-
-	if resAccessToken.ErrCode != 0 {
-		err = fmt.Errorf("get stable access_token error : errcode=%v , errormsg=%v", resAccessToken.ErrCode, resAccessToken.ErrMsg)
-		return
-	}
-	return
-}
-
-// WorkAccessToken 企业微信AccessToken 获取
-type WorkAccessToken struct {
-	CorpID          string
-	CorpSecret      string
-	cacheKeyPrefix  string
-	cache           cache.Cache
-	accessTokenLock *sync.Mutex
-}
-
-// NewWorkAccessToken new WorkAccessToken
-func NewWorkAccessToken(corpID, corpSecret, cacheKeyPrefix string, cache cache.Cache) AccessTokenContextHandle {
-	if cache == nil {
-		panic("cache the not exist")
-	}
-	return &WorkAccessToken{
-		CorpID:          corpID,
-		CorpSecret:      corpSecret,
-		cache:           cache,
-		cacheKeyPrefix:  cacheKeyPrefix,
-		accessTokenLock: new(sync.Mutex),
-	}
-}
-
-// GetAccessToken 企业微信获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *WorkAccessToken) GetAccessToken() (accessToken string, err error) {
-	return ak.GetAccessTokenContext(context.Background())
-}
-
-// GetAccessTokenContext 企业微信获取access_token,先从cache中获取，没有则从服务端获取
-func (ak *WorkAccessToken) GetAccessTokenContext(ctx context.Context) (accessToken string, err error) {
-	// 加上lock，是为了防止在并发获取token时，cache刚好失效，导致从微信服务器上获取到不同token
-	ak.accessTokenLock.Lock()
-	defer ak.accessTokenLock.Unlock()
-	accessTokenCacheKey := fmt.Sprintf("%s_access_token_%s", ak.cacheKeyPrefix, ak.CorpID)
-	val := ak.cache.Get(accessTokenCacheKey)
-	if val != nil {
-		accessToken = val.(string)
-		return
-	}
-
-	// cache失效，从微信服务器获取
-	var resAccessToken ResAccessToken
-	resAccessToken, err = GetTokenFromServerContext(ctx, fmt.Sprintf(workAccessTokenURL, ak.CorpID, ak.CorpSecret))
-	if err != nil {
-		return
-	}
-
-	expires := resAccessToken.ExpiresIn - 1500
-	err = ak.cache.Set(accessTokenCacheKey, resAccessToken.AccessToken, time.Duration(expires)*time.Second)
-
-	accessToken = resAccessToken.AccessToken
-	return
-}
-
-// GetTokenFromServer 强制从微信服务器获取token
-func GetTokenFromServer(url string) (resAccessToken ResAccessToken, err error) {
-	return GetTokenFromServerContext(context.Background(), url)
-}
-
-// GetTokenFromServerContext 强制从微信服务器获取token
-func GetTokenFromServerContext(ctx context.Context, url string) (resAccessToken ResAccessToken, err error) {
-	var body []byte
-	body, err = util.HTTPGetContext(ctx, url)
-	if err != nil {
-		return
-	}
-	err = json.Unmarshal(body, &resAccessToken)
-	if err != nil {
-		return
-	}
-	if resAccessToken.ErrCode != 0 {
-		err = fmt.Errorf("get access_token error : errcode=%v , errormsg=%v", resAccessToken.ErrCode, resAccessToken.ErrMsg)
-		return
-	}
-	return
-}

credential/default_access_token_test.go

@@ -1,19 +0,0 @@
-package credential
-
-import (
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-	"gopkg.in/h2non/gock.v1"
-)
-
-// TestGetTicketFromServer .
-func TestGetTicketFromServer(t *testing.T) {
-	defer gock.Off()
-	gock.New(getTicketURL).Reply(200).JSON(&ResTicket{Ticket: "mock-ticket", ExpiresIn: 10})
-	ticket, err := GetTicketFromServer("arg-ak")
-	assert.Nil(t, err)
-	assert.Equal(t, int64(0), ticket.ErrCode)
-	assert.Equal(t, "mock-ticket", ticket.Ticket, "they should be equal")
-	assert.Equal(t, int64(10), ticket.ExpiresIn, "they should be equal")
-}

credential/default_js_ticket.go

@@ -1,87 +0,0 @@
-package credential
-
-import (
-	"encoding/json"
-	"fmt"
-	"sync"
-	"time"
-
-	"github.com/silenceper/wechat/v2/cache"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-// getTicketURL 获取ticket的url
-const getTicketURL = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=%s&type=jsapi"
-
-// DefaultJsTicket 默认获取js ticket方法
-type DefaultJsTicket struct {
-	appID          string
-	cacheKeyPrefix string
-	cache          cache.Cache
-	// jsAPITicket 读写锁 同一个AppID一个
-	jsAPITicketLock *sync.Mutex
-}
-
-// NewDefaultJsTicket new
-func NewDefaultJsTicket(appID string, cacheKeyPrefix string, cache cache.Cache) JsTicketHandle {
-	return &DefaultJsTicket{
-		appID:           appID,
-		cache:           cache,
-		cacheKeyPrefix:  cacheKeyPrefix,
-		jsAPITicketLock: new(sync.Mutex),
-	}
-}
-
-// ResTicket 请求jsapi_tikcet返回结果
-type ResTicket struct {
-	util.CommonError
-
-	Ticket    string `json:"ticket"`
-	ExpiresIn int64  `json:"expires_in"`
-}
-
-// GetTicket 获取jsapi_ticket
-func (js *DefaultJsTicket) GetTicket(accessToken string) (ticketStr string, err error) {
-	// 先从cache中取
-	jsAPITicketCacheKey := fmt.Sprintf("%s_jsapi_ticket_%s", js.cacheKeyPrefix, js.appID)
-	if val := js.cache.Get(jsAPITicketCacheKey); val != nil {
-		return val.(string), nil
-	}
-
-	js.jsAPITicketLock.Lock()
-	defer js.jsAPITicketLock.Unlock()
-
-	// 双检，防止重复从微信服务器获取
-	if val := js.cache.Get(jsAPITicketCacheKey); val != nil {
-		return val.(string), nil
-	}
-
-	var ticket ResTicket
-	ticket, err = GetTicketFromServer(accessToken)
-	if err != nil {
-		return
-	}
-	expires := ticket.ExpiresIn - 1500
-	err = js.cache.Set(jsAPITicketCacheKey, ticket.Ticket, time.Duration(expires)*time.Second)
-	ticketStr = ticket.Ticket
-	return
-}
-
-// GetTicketFromServer 从服务器中获取ticket
-func GetTicketFromServer(accessToken string) (ticket ResTicket, err error) {
-	var response []byte
-	url := fmt.Sprintf(getTicketURL, accessToken)
-	response, err = util.HTTPGet(url)
-	if err != nil {
-		return
-	}
-	err = json.Unmarshal(response, &ticket)
-	if err != nil {
-		return
-	}
-	if ticket.ErrCode != 0 {
-		err = fmt.Errorf("getTicket Error : errcode=%d , errmsg=%s", ticket.ErrCode, ticket.ErrMsg)
-		return
-	}
-	return
-}

credential/js_ticket.go

@@ -1,7 +0,0 @@
-package credential
-
-// JsTicketHandle js ticket获取
-type JsTicketHandle interface {
-	// GetTicket 获取ticket
-	GetTicket(accessToken string) (ticket string, err error)
-}

device/authorize.go

@@ -1,11 +1,10 @@
-// Package device 设备相关接口
 package device
 
 import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
@@ -23,13 +22,13 @@ type reqDeviceAuthorize struct {
 	// 请求操作的类型，限定取值为：0：设备授权（缺省值为0） 1：设备更新（更新已授权设备的各属性值）
 	OpType string `json:"op_type,omitempty"`
 	// 设备的产品编号（由微信硬件平台分配）。可在公众号设备功能管理页面查询。
-	// 当 op_type 为‘0’，product_id 为‘1’时，不要填写 product_id 字段（会引起不必要错误）；
-	// 当 op_typy 为‘0’，product_id 不为‘1’时，必须填写 product_id 字段；
-	// 当 op_type 为 1 时，不要填写 product_id 字段。
+	//当 op_type 为‘0’，product_id 为‘1’时，不要填写 product_id 字段（会引起不必要错误）；
+	//当 op_typy 为‘0’，product_id 不为‘1’时，必须填写 product_id 字段；
+	//当 op_type 为 1 时，不要填写 product_id 字段。
 	ProductID string `json:"product_id,omitempty"`
 }
 
-// ReqDevice 设备授权实体
+//ReqDevice 设备授权实体
 type ReqDevice struct {
 	// 设备的 device id
 	ID string `json:"id"`
@@ -42,22 +41,22 @@ type ReqDevice struct {
 	//	ble – 3
 	//	wifi -- 4
 	//	一个设备可以支持多种连接类型，用符号"|"做分割，客户端优先选择靠前的连接方式（优先级按|关系的排序依次降低），举例：
-	//	1：表示设备仅支持andiod classic bluetooth 1|2：表示设备支持android 和ios 两种classic bluetooth，但是客户端优先选择android classic bluetooth 协议，如果android classic bluetooth协议连接失败，再选择ios classic bluetooth协议进行连接
+	//	1：表示设备仅支持andiod classic bluetooth 1|2：表示设备支持andiod 和ios 两种classic bluetooth，但是客户端优先选择andriod classic bluetooth 协议，如果andriod classic bluetooth协议连接失败，再选择ios classic bluetooth协议进行连接
 	//	（注：安卓平台不同时支持BLE和classic类型）
 	ConnectProtocol string `json:"connect_protocol"`
-	// auth及通信的加密key，第三方需要将key烧制在设备上（128bit），格式采用16进制串的方式（长度为32字节），不需要0X前缀，如： 1234567890ABCDEF1234567890ABCDEF
+	//auth及通信的加密key，第三方需要将key烧制在设备上（128bit），格式采用16进制串的方式（长度为32字节），不需要0X前缀，如： 1234567890ABCDEF1234567890ABCDEF
 	AuthKey string `json:"auth_key"`
 	// 断开策略，目前支持： 1：退出公众号页面时即断开连接 2：退出公众号之后保持连接不断开
 	CloseStrategy string `json:"close_strategy"`
-	// 连接策略，32位整型，按bit位置位，目前仅第1bit和第3bit位有效（bit置0为无效，1为有效；第2bit已被废弃），且bit位可以按或置位（如1|4=5），各bit置位含义说明如下：
-	// 1：（第1bit置位）在公众号对话页面，不停的尝试连接设备
-	// 4：（第3bit置位）处于非公众号页面（如主界面等），微信自动连接。当用户切换微信到前台时，可能尝试去连接设备，连上后一定时间会断开
+	//连接策略，32位整型，按bit位置位，目前仅第1bit和第3bit位有效（bit置0为无效，1为有效；第2bit已被废弃），且bit位可以按或置位（如1|4=5），各bit置位含义说明如下：
+	//1：（第1bit置位）在公众号对话页面，不停的尝试连接设备
+	//4：（第3bit置位）处于非公众号页面（如主界面等），微信自动连接。当用户切换微信到前台时，可能尝试去连接设备，连上后一定时间会断开
 	ConnStrategy string `json:"conn_strategy"`
 	// auth version，设备和微信进行auth时，会根据该版本号来确认auth buf和auth key的格式（各version对应的auth buf及key的具体格式可以参看“客户端蓝牙外设协议”），该字段目前支持取值：
 	// 0：不加密的version
 	// 1：version 1
 	AuthVer string `json:"auth_ver"`
-	// 表示mac地址在厂商广播manufacture data里含有mac地址的偏移，取值如下：
+	// 表示mac地址在厂商广播manufature data里含有mac地址的偏移，取值如下：
 	// -1：在尾部、
 	// -2：表示不包含mac地址 其他：非法偏移
 	ManuMacPos string `json:"manu_mac_pos"`
@@ -69,7 +68,7 @@ type ReqDevice struct {
 	BleSimpleProtocol string `json:"ble_simple_protocol,omitempty"`
 }
 
-// ResBaseInfo 授权回调实体
+//ResBaseInfo 授权回调实体
 type ResBaseInfo struct {
 	BaseInfo struct {
 		DeviceType string `json:"device_type"`

device/bind.go

@@ -4,7 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
 // ReqBind 设备绑定解绑共通实体

device/device.go

@@ -4,8 +4,8 @@ import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/officialaccount/context"
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
@@ -19,12 +19,12 @@ const (
 	uriState        = "https://api.weixin.qq.com/device/get_stat"
 )
 
-// Device struct
+//Device struct
 type Device struct {
 	*context.Context
 }
 
-// NewDevice 实例
+//NewDevice 实例
 func NewDevice(context *context.Context) *Device {
 	device := new(Device)
 	device.Context = context

device/message.go

@@ -1,6 +1,6 @@
 package device
 
-// MsgDevice 设备消息响应
+//MsgDevice 设备消息响应
 type MsgDevice struct {
 	DeviceType string
 	DeviceID   string

device/qrcode.go

@@ -4,10 +4,10 @@ import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
-// ResCreateQRCode 获取二维码的返回实体
+//ResCreateQRCode 获取二维码的返回实体
 type ResCreateQRCode struct {
 	util.CommonError
 	DeviceNum int `json:"device_num"`
@@ -42,7 +42,7 @@ func (d *Device) CreateQRCode(devices []string) (res ResCreateQRCode, err error)
 	return
 }
 
-// ResVerifyQRCode 验证授权结果实体
+//ResVerifyQRCode 验证授权结果实体
 type ResVerifyQRCode struct {
 	util.CommonError
 	DeviceType string `json:"device_type"`
@@ -60,7 +60,7 @@ func (d *Device) VerifyQRCode(ticket string) (res ResVerifyQRCode, err error) {
 	req := map[string]interface{}{
 		"ticket": ticket,
 	}
-
+	fmt.Println(req)
 	var response []byte
 	if response, err = util.PostJSON(uri, req); err != nil {
 		return

doc.go

@@ -3,10 +3,31 @@ Package wechat provide wechat sdk for go
 
 使用Golang开发的微信SDK，简单、易用。
 
+以下是一个处理消息接收以及回复的例子：
+
+	//配置微信参数
+	config := &wechat.Config{
+		AppID:          "xxxx",
+		AppSecret:      "xxxx",
+		Token:          "xxxx",
+		EncodingAESKey: "xxxx",
+	}
+	wc := wechat.NewWechat(config)
+
+	// 传入request和responseWriter
+	server := wc.GetServer(request, responseWriter)
+	server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
+
+		//回复消息：演示回复用户发送的消息
+		text := message.NewText(msg.Content)
+		return &message.Reply{message.MsgText, text}
+	})
+
+	server.Serve()
+	server.Send()
+
 
 更多信息：https://github.com/silenceper/wechat
 
 */
-
-// Package wechat provide wechat sdk for go
 package wechat

doc/api/README.md

@@ -1,17 +0,0 @@
-# API 文档
-
-已完成以及未完成API列表汇总
-
-如果有兴趣参与贡献，可以在具体的API表格后面标识自己为贡献者以及完成时间，例如：
-
-|          名称           | 请求方式 | URL                        | 是否已实现 | 使用方法 |贡献者|完成时间|
-| :---------------------: | -------- | :------------------------- | ---------- | -------- |-------- |-------- |
-| 获取公众号类目       | GET      | /wxaapi/newtmpl/getcategory            | NO         |   |silenceper| 2021-12-20|
-
-- [微信公众号](./officialaccount.md)
-- [小程序](./miniprogram.md)
-- [小游戏](./minigame.md)
-- [开放平台](./oplatform.md)
-- [微信支付](./wxpay.md)
-- [企业微信](./work.md)
-- [智能对话](./aispeech.md)

doc/api/aispeech.md

@@ -1,3 +0,0 @@
-# 智能对话
-
-TODO

doc/api/minigame.md

@@ -1,3 +0,0 @@
-# 小游戏
-
-TODO

doc/api/miniprogram.md

@@ -1,50 +0,0 @@
-# 小程序
-
-## 基础接口
-
-TODO
-
-## 内容安全
-
-[官方文档](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/sec-check/security.mediaCheckAsync.html)
-
-|               名称                | 请求方式 | URL                              | 是否已实现 | 使用方法                               |
-| :-------------------------------: | -------- | :------------------------------- | ---------- | -------------------------------------- |
-| 异步校验图片/音频 <sub>v1.0</sub> | POST     | /wxa/media_check_async           | YES        | (security *Security) MediaCheckAsyncV1 |
-| 同步校验一张图片 <sub>v1.0</sub>  | POST     | /wxa/img_sec_check               | YES        | (security *Security) ImageCheckV1      |
-|         异步校验图片/音频         | POST     | /wxa/media_check_async?version=2 | YES        | (security *Security) MediaCheckAsync   |
-| 同步检查一段文本 <sub>v1.0</sub>  | POST     | /wxa/msg_sec_check               | YES        | (security *Security) MsgCheckV1        |
-|         同步检查一段文本          | POST     | /wxa/msg_sec_check?version=2     | YES        | (security *Security) MsgCheck          |
-
-
-## OCR
-
-[官方文档](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/ocr/ocr.bankcard.html)
-
-|      名称      | 请求方式 | URL                    | 是否已实现 | 使用方法 |
-| :------------: | -------- | :--------------------- | ---------- | -------- |
-|   银行卡识别   | POST     | /cv/ocr/bankcard       |            |          |
-|  营业执照识别  | POST     | /cv/ocr/bizlicense     |            |          |
-|   驾驶证识别   | POST     | /cv/ocr/drivinglicense |            |          |
-|   身份证识别   | POST     | /cv/ocr/idcard         |            |          |
-| 通用印刷体识别 | POST     | /cv/ocr/comm           |            |          |
-|   行驶证识别   | POST     | /cv/ocr/driving        |            |          |
-
-
-## 手机号
-
-[官方文档](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/phonenumber/phonenumber.getPhoneNumber.html)
-
-|        名称        | 请求方式 | URL                              | 是否已实现 | 使用方法                            |
-| :----------------: | -------- | :------------------------------- | ---------- | ----------------------------------- |
-| code换取用户手机号 | POST     | /wxa/business/getuserphonenumber | YES        | (business *Business) GetPhoneNumber |
-
-
-## 安全风控
-
-[官方文档](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/safety-control-capability/riskControl.getUserRiskRank.html)
-
-|        名称        | 请求方式 | URL                  | 是否已实现 | 使用方法                                   |
-| :----------------: | -------- | :------------------- | ---------- | ------------------------------------------ |
-| 获取用户的安全等级 | POST     | /wxa/getuserriskrank | YES        | (riskControl *RiskControl) GetUserRiskRank |
-

doc/api/officialaccount.md

@@ -1,238 +0,0 @@
-# 微信公众号 API 列表
-
-## 基础接口
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html)
-
-|           名称            | 请求方式 | URL                        | 是否已实现 | 使用方法 |
-| :-----------------------: | -------- | :------------------------- | ---------- | -------- |
-|     获取 Access token     | GET      | /cgi-bin/token             | YES        |          |
-|  获取微信服务器 IP 地址   | GET      | /cgi-bin/get_api_domain_ip | YES        |          |
-| 获取微信 callback IP 地址 | GET      | /cgi-bin/getcallbackip     | YES        |          |
-|     清理接口调用次数      | POST     | /cgi-bin/clear_quota       | YES        |          |
-
-## 订阅通知
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Subscription_Messages/api.html)
-
-| 名称                 | 请求方式 | URL                                    | 是否已实现 | 使用方法                                     |
-| -------------------- | -------- | -------------------------------------- | ---------- | -------------------------------------------- |
-| 选用模板             | POST     | /wxaapi/newtmpl/addtemplate            | YES        | (tpl \*Subscribe) Add                        |
-| 删除模板             | POST     | /wxaapi/newtmpl/deltemplate            | YES        | (tpl \*Subscribe) Delete                     |
-| 获取公众号类目       | GET      | /wxaapi/newtmpl/getcategory            | YES        | (tpl \*Subscribe) GetCategory                |
-| 获取模板中的关键词   | GET      | /wxaapi/newtmpl/getpubtemplatekeywords | YES        | (tpl \*Subscribe) GetPubTplKeyWordsByID      |
-| 获取类目下的公共模板 | GET      | /wxaapi/newtmpl/getpubtemplatetitles   | YES        | (tpl \*Subscribe) GetPublicTemplateTitleList |
-| 获取私有模板列表     | GET      | /wxaapi/newtmpl/gettemplate            | YES        | (tpl \*Subscribe) List()                     |
-| 发送订阅通知         | POST     | /cgi-bin/message/subscribe/bizsend     | YES        | (tpl \*Subscribe) Send                       |
-
-## 客服消息
-
-### PC 客服能力
-
-#### 客服管理
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Customer_Service/Customer_Service_Management.html)
-
-| 名称             | 请求方式  | URL                                    | 是否已实现 | 使用方法                         |
-| ---------------- | --------- | -------------------------------------- | ---------- | -------------------------------- |
-| 获取客服基本信息 | GET       | /cgi-bin/customservice/getkflist       | YES        | (csm \*Manager) List             |
-| 添加客服帐号     | POST      | /customservice/kfaccount/add           | YES        | (csm \*Manager) Add              |
-| 邀请绑定客服帐号 | POST      | /customservice/kfaccount/inviteworker  | YES        | (csm \*Manager) InviteBind       |
-| 设置客服信息     | POST      | /customservice/kfaccount/update        | YES        | (csm \*Manager) Update           |
-| 上传客服头像     | POST/FORM | /customservice/kfaccount/uploadheadimg | YES        | (csm \*Manager) UploadHeadImg    |
-| 删除客服帐号     | POST      | /customservice/kfaccount/del           | YES        | (csm \*Manager) Delete           |
-| 获取在线客服     | POST      | /cgi-bin/customservice/getonlinekflist | YES        | (csm \*Manager) OnlineList       |
-| 下发客服输入状态 | POST      | /cgi-bin/message/custom/typing         | YES        | (csm \*Manager) SendTypingStatus |
-
-#### 会话控制
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Customer_Service/Session_control.html)
-
-| 名称               | 请求方式 | URL                                     | 是否已实现 | 使用方法 |
-| ------------------ | -------- | --------------------------------------- | ---------- | -------- |
-| 创建会话           | POST     | /customservice/kfsession/create         | NO         |          |
-| 获取客户会话状态   | GET      | /customservice/kfsession/getsession     | NO         |          |
-| 获取客服会话列表   | GET      | /customservice/kfsession/getsessionlist | NO         |          |
-| 获取未接入会话列表 | POST     | /customservice/kfsession/getwaitcase    | NO         |          |
-
-#### 获取聊天记录
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Customer_Service/Obtain_chat_transcript.html)
-
-| 名称         | 请求方式 | URL                                 | 是否已实现 | 使用方法 |
-| ------------ | -------- | ----------------------------------- | ---------- | -------- |
-| 获取聊天记录 | POST     | /customservice/msgrecord/getmsglist | NO         |          |
-
-### 对话能力
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/guide.html)
-
-#### 顾问管理
-
-| 名称                           | 请求方式 | URL                                    | 是否已实现 | 使用方法 |
-| ------------------------------ | -------- | -------------------------------------- | ---------- | -------- |
-| 添加顾问                       | POST     | /cgi-bin/guide/addguideacct            | NO         |          |
-| 获取顾问信息                   | POST     | /cgi-bin/guide/getguideacct            | NO         |          |
-| 修改顾问信息                   | POST     | /cgi-bin/guide/updateguideacct         | NO         |          |
-| 删除顾问                       | POST     | /cgi-bin/guide/delguideacct            | NO         |          |
-| 获取服务号顾问列表             | POST     | /cgi-bin/guide/getguideacctlist        | NO         |          |
-| 生成顾问二维码                 | POST     | /cgi-bin/guide/guidecreateqrcode       | NO         |          |
-| 获取顾问聊天记录               | POST     | /cgi-bin/guide/getguidebuyerchatrecord | NO         |          |
-| 设置快捷回复与关注自动回复     | POST     | /cgi-bin/guide/setguideconfig          | NO         |          |
-| 获取快捷回复与关注自动回复     | POST     | /cgi-bin/guide/getguideconfig          | NO         |          |
-| 设置敏感词与离线自动回复       | POST     | /cgi-bin/guide/setguideacctconfig      | NO         |          |
-| 获取离线自动回复与敏感词       | POST     | /cgi-bin/guide/getguideacctconfig      | NO         |          |
-| 允许微信用户复制小程序页面路径 | POST     | /cgi-bin/guide/pushshowwxapathmenu     | NO         |          |
-| 新建顾问分组                   | POST     | /cgi-bin/guide/newguidegroup           | NO         |          |
-| 获取顾问分组列表               | POST     | /cgi-bin/guide/getguidegrouplist       | NO         |          |
-| 获取顾问分组信息               | POST     | /cgi-bin/guide/getgroupinfo            | NO         |          |
-| 分组内添加顾问                 | POST     | /cgi-bin/guide/addguide2guidegroup     | NO         |          |
-| 分组内删除顾问                 | POST     | /cgi-bin/guide/delguide2guidegroup     | NO         |          |
-| 获取顾问所在分组               | POST     | /cgi-bin/guide/getgroupbyguide         | NO         |          |
-| 删除指定顾问分组               | POST     | /cgi-bin/guide/delguidegroup           | NO         |          |
-
-#### 客户管理
-
-| 名称                     | 请求方式 | URL                                         | 是否已实现 | 使用方法 |
-| ------------------------ | -------- | ------------------------------------------- | ---------- | -------- |
-| 为顾问分配客户           | POST     | /cgi-bin/guide/addguidebuyerrelation        | NO         |          |
-| 为顾问移除客户           | POST     | /cgi-bin/guide/delguidebuyerrelation        | NO         |          |
-| 获取顾问的客户列表       | POST     | /cgi-bin/guide/getguidebuyerrelationlist    | NO         |          |
-| 为客户更换顾问           | POST     | /cgi-bin/guide/rebindguideacctforbuyer      | NO         |          |
-| 修改客户昵称             | POST     | /cgi-bin/guide/updateguidebuyerrelation     | NO         |          |
-| 查询客户所属顾问         | POST     | /cgi-bin/guide/getguidebuyerrelationbybuyer | NO         |          |
-| 查询指定顾问和客户的关系 | POST     | /cgi-bin/guide/getguidebuyerrelation        | NO         |          |
-
-#### 标签管理
-
-| 名称               | 请求方式 | URL                                    | 是否已实现 | 使用方法 |
-| ------------------ | -------- | -------------------------------------- | ---------- | -------- |
-| 新建标签类型       | POST     | /cgi-bin/guide/newguidetagoption       | NO         |          |
-| 删除标签类型       | POST     | /cgi-bin/guide/delguidetagoption       | NO         |          |
-| 为标签添加可选值   | POST     | /cgi-bin/guide/addguidetagoption       | NO         |          |
-| 获取标签和可选值   | POST     | /cgi-bin/guide/getguidetagoption       | NO         |          |
-| 为客户设置标签     | POST     | /cgi-bin/guide/addguidebuyertag        | NO         |          |
-| 查询客户标签       | POST     | /cgi-bin/guide/getguidebuyertag        | NO         |          |
-| 根据标签值筛选客户 | POST     | /cgi-bin/guide/queryguidebuyerbytag    | NO         |          |
-| 删除客户标签       | POST     | /cgi-bin/guide/delguidebuyertag        | NO         |          |
-| 设置自定义客户信息 | POST     | /cgi-bin/guide/addguidebuyerdisplaytag | NO         |          |
-| 获取自定义客户信息 | POST     | /cgi-bin/guide/getguidebuyerdisplaytag | NO         |          |
-
-#### 素材管理
-
-| 名称               | 请求方式 | URL                                  | 是否已实现 | 使用方法 |
-| ------------------ | -------- | ------------------------------------ | ---------- | -------- |
-| 添加小程序卡片素材 | POST     | /cgi-bin/guide/setguidecardmaterial  | NO         |          |
-| 查询小程序卡片素材 | POST     | /cgi-bin/guide/getguidecardmaterial  | NO         |          |
-| 删除小程序卡片素材 | POST     | /cgi-bin/guide/delguidecardmaterial  | NO         |          |
-| 添加图片素材       | POST     | /cgi-bin/guide/setguideimagematerial | NO         |          |
-| 查询图片素材       | POST     | /cgi-bin/guide/getguideimagematerial | NO         |          |
-| 删除图片素材       | POST     | /cgi-bin/guide/delguideimagematerial | NO         |          |
-| 添加文字素材       | POST     | /cgi-bin/guide/setguidewordmaterial  | NO         |          |
-| 查询文字素材       | POST     | /cgi-bin/guide/getguidewordmaterial  | NO         |          |
-| 删除文字素材       | POST     | /cgi-bin/guide/delguidewordmaterial  | NO         |          |
-
-#### 群发任务管理
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Shopping_Guide/task-account/shopping-guide.addGuideMassendJob.html)
-
-| 名称                 | 请求方式 | URL                                   | 是否已实现 | 使用方法 |
-| -------------------- | -------- | ------------------------------------- | ---------- | -------- |
-| 添加群发任务         | POST     | /cgi-bin/guide/addguidemassendjob     | NO         |          |
-| 获取群发任务列表     | POST     | /cgi-bin/guide/getguidemassendjoblist | NO         |          |
-| 获取指定群发任务信息 | POST     | /cgi-bin/guide/getguidemassendjob     | NO         |          |
-| 修改群发任务         | POST     | /cgi-bin/guide/updateguidemassendjob  | NO         |          |
-| 取消群发任务         | POST     | /cgi-bin/guide/cancelguidemassendjob  | NO         |          |
-
-## 微信网页开发
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)
-
-| 名称                                                                    | 请求方式 | URL                                                 | 是否已实现 | 使用方法                             |
-| ----------------------------------------------------------------------- | -------- | --------------------------------------------------- | ---------- | ------------------------------------ |
-| 获取跳转的 url 地址                                                     | GET      | https://open.weixin.qq.com/connect/oauth2/authorize | YES        | (oauth \*Oauth) GetRedirectURL       |
-| 获取网页应用跳转的 url 地址                                             | GET      | https://open.weixin.qq.com/connect/qrconnect        | YES        | (oauth \*Oauth) GetWebAppRedirectURL |
-| 通过网页授权的 code 换取 access_token(区别于 context 中的 access_token) | GET      | /sns/oauth2/access_token                            | YES        | (oauth \*Oauth) GetUserAccessToken   |
-| 刷新 access_token                                                       | GET      | /sns/oauth2/refresh_token?                          | YES        | (oauth \*Oauth) RefreshAccessToken   |
-| 检验 access_token 是否有效                                              | GET      | /sns/auth                                           | YES        | (oauth \*Oauth) CheckAccessToken(    |
-| 拉取用户信息(需 scope 为 snsapi_userinfo)                               | GET      | /sns/userinfo                                       | YES        | (oauth \*Oauth) GetUserInfo          |
-| 获取 jssdk 需要的配置参数                                               | GET      | /cgi-bin/ticket/getticket                           | YES        | (js \*Js) GetConfig                  |
-
-## 素材管理
-
-## 草稿箱
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Draft_Box/Add_draft.html)
-
-| 名称                        | 请求方式 | URL                                                          | 是否已实现 | 使用方法                      |
-| --------------------------- | -------- | ------------------------------------------------------------ | ---------- | ----------------------------- |
-| 新建草稿                    | POST     | /cgi-bin/draft/add                                           | YES        | (draft \*Draft) AddDraft      |
-| 获取草稿                    | POST     | /cgi-bin/draft/get                                           | YES        | (draft \*Draft) GetDraft      |
-| 删除草稿                    | POST     | /cgi-bin/draft/delete                                        | YES        | (draft \*Draft) DeleteDraft   |
-| 修改草稿                    | POST     | /cgi-bin/draft/update                                        | YES        | (draft \*Draft) UpdateDraft   |
-| 获取草稿总数                | GET      | /cgi-bin/draft/count                                         | YES        | (draft \*Draft) CountDraft    |
-| 获取草稿列表                | POST     | /cgi-bin/draft/batchget                                      | YES        | (draft \*Draft) PaginateDraft |
-| MP 端开关（仅内测期间使用） | POST     | /cgi-bin/draft/switch<br />/cgi-bin/draft/switch?checkonly=1 | NO         |                               |
-
-## 发布能力
-
-[官方文档](https://developers.weixin.qq.com/doc/offiaccount/Publish/Publish.html)
-
-说明：「发表记录」包括群发和发布。
-
-注意：该接口，只能处理 "发布" 相关的信息，无法操作和获取 "群发" 相关内容！！[官方回复](https://developers.weixin.qq.com/community/develop/doc/0002a4fb2109d8f7a91d421c556c00)
-
-- 群发：主动推送给粉丝，历史消息可看，被搜一搜收录，可以限定部分的粉丝接收到。
-- 发布：不会主动推给粉丝，历史消息列表看不到，但是是公开给所有人的文章。也不会占用群发的次数。每天可以发布多篇内容。可以用于自动回复、自定义菜单、页面模板和话题中，发布成功时会生成一个永久链接。
-
-| 名称                           | 请求方式 | URL                             | 是否已实现 | 使用方法                                 |
-| ------------------------------ | -------- | ------------------------------- | ---------- | ---------------------------------------- |
-| 发布接口                       | POST     | /cgi-bin/freepublish/submit     | YES        | (freePublish \*FreePublish) Publish      |
-| 发布状态轮询接口               | POST     | /cgi-bin/freepublish/get        | YES        | (freePublish \*FreePublish) SelectStatus |
-| 事件推送发布结果               |          |                                 | YES        | EventPublishJobFinish                    |
-| 删除发布                       | POST     | /cgi-bin/freepublish/delete     | YES        | (freePublish \*FreePublish) Delete       |
-| 通过 article_id 获取已发布文章 | POST     | /cgi-bin/freepublish/getarticle | YES        | (freePublish \*FreePublish) First        |
-| 获取成功发布列表               | POST     | /cgi-bin/freepublish/batchget   | YES        | (freePublish \*FreePublish) Paginate     |
-
-## 图文消息留言管理
-
-## 用户管理
-
-| 名称                                       | 请求方式 | URL                                    | 是否已实现 | 使用方法                           |
-| ------------------------------------------ | -------- | -------------------------------------- | ---------- | ---------------------------------- |
-| 获取指定 OpenID 变化列表（公众号账号迁移） | POST     | /cgi-bin/changeopenid                  | YES        | (user \*User) ListChangeOpenIDs    |
-| 获取所有用户 OpenID 列表（公众号账号迁移） |          |                                        | YES        | (user \*User) ListAllChangeOpenIDs |
-| 获取用户基本信息                           | GET      | /cgi-bin/user/info                     | YES        | (user \*User) GetUserInfo          |
-| 设置用户备注名                             | POST     | /cgi-bin/user/info/updateremark        | YES        | (user \*User) UpdateRemark         |
-| 获取用户列表                               | GET      | /cgi-bin/user/get                      | YES        | (user \*User) ListUserOpenIDs      |
-| 获取所有用户 OpenID 列表                   |          |                                        | YES        | (user \*User) ListAllUserOpenIDs   |
-| 获取公众号的黑名单列表                     | POST     | /cgi-bin/tags/members/getblacklist     | YES        | (user \*User) GetBlackList         |
-| 获取公众号的所有黑名单列表                 |          |                                        | YES        | (user \*User) GetAllBlackList      |
-| 拉黑用户                                   | POST     | /cgi-bin/tags/members/batchblacklist   | YES        | (user \*User) BatchBlackList       |
-| 取消拉黑用户                               | POST     | /cgi-bin/tags/members/batchunblacklist | YES        | (user \*User) BatchUnBlackList     |
-| 创建标签                                   | POST     | /cgi-bin/tags/create                   | YES        | (user \*User) CreateTag            |
-| 删除标签                                   | POST     | /cgi-bin/tags/delete                   | YES        | (user \*User) DeleteTag            |
-| 编辑标签                                   | POST     | /cgi-bin/tags/update                   | YES        | (user \*User) UpdateTag            |
-| 获取公众号已创建的标签                     | GET      | /cgi-bin/tags/get                      | YES        | (user \*User) GetTag               |
-| 获取标签下粉丝列表                         | POST     | /cgi-bin/user/tag/get                  | YES        | (user \*User) OpenIDListByTag      |
-| 批量为用户打标签                           | POST     | /cgi-bin/tags/members/batchtagging     | YES        | (user \*User) BatchTag             |
-| 批量为用户取消标签                         | POST     | /cgi-bin/tags/members/batchuntagging   | YES        | (user \*User) BatchUntag           |
-| 获取用户身上的标签列表                     | POST     | /cgi-bin/tags/getidlist                | YES        | (user \*User) UserTidList          |
-
-## 账号管理
-
-## 数据统计
-
-## 微信卡券
-
-## 微信门店
-
-## 智能接口
-
-## 微信设备功能
-
-## 微信“一物一码”
-
-## 微信发票
-
-## 微信非税缴费

doc/api/oplatform.md

@@ -1 +0,0 @@
-# 开放平台

doc/api/work.md

@@ -1,131 +0,0 @@
-# 企业微信
-
-host: https://qyapi.weixin.qq.com/
-
-## 微信客服
-
-[官方文档](https://work.weixin.qq.com/api/doc/90000/90135/94638)
-
-### 客服账号管理
-
-[官方文档](https://open.work.weixin.qq.com/api/doc/90001/90143/94684)
-
-|       名称       | 请求方式 | URL                         | 是否已实现 | 使用方法                             |贡献者       |
-| :--------------: | -------- | :-------------------------- | ---------- | -------------------------------|------------|
-|   添加客服帐号   | POST     | /cgi-bin/kf/account/add     | YES        | (r *Client) AccountAdd           | NICEXAI    |
-|   删除客服帐号   | POST     | /cgi-bin/kf/account/del     | YES        | (r *Client) AccountDel           | NICEXAI    |
-|   修改客服帐号   | POST     | /cgi-bin/kf/account/update  | YES        | (r *Client) AccountUpdate        | NICEXAI    |
-| 获取客服帐号列表 | GET      | /cgi-bin/kf/account/list     | YES        | (r *Client) AccountList          | NICEXAI    |
-| 获取客服帐号链接 | GET      | /cgi-bin/kf/add_contact_way  | YES        | (r *Client) AddContactWay        | NICEXAI    |
-
-### 接待人员列表
-
-[官方文档](https://open.work.weixin.qq.com/api/doc/90001/90143/94693)
-
-|       名称       | 请求方式 | URL                         | 是否已实现 | 使用方法                             |贡献者       |
-| :--------------: | -------- | :-------------------------- | ---------- | -------------------------------|------------|
-|   添加接待人员     | POST     | /cgi-bin/kf/servicer/add    | YES        | (r *Client) ReceptionistAdd     | NICEXAI    |
-|   删除接待人员     | POST     | /cgi-bin/kf/servicer/del    | YES        | (r *Client) ReceptionistDel     | NICEXAI    |
-| 获取接待人员列表    | GET      | /cgi-bin/kf/servicer/list   | YES        | (r *Client) ReceptionistList    | NICEXAI    |
-
-### 会话分配与消息收发
-
-[官方文档](https://open.work.weixin.qq.com/api/doc/90001/90143/94694)
-
-|       名称       | 请求方式 | URL                               | 是否已实现   | 使用方法                          |贡献者       |
-| :--------------: | -------- | :-------------------------------| ---------- | ------------------------------- |------------|
-|   获取会话状态     | POST     | /cgi-bin/kf/service_state/get   | YES        | (r *Client) ServiceStateGet     | NICEXAI    |
-|   变更会话状态     | POST     | /cgi-bin/kf/service_state/trans | YES        | (r *Client) ServiceStateTrans   | NICEXAI    |
-|   读取消息        | POST     | /cgi-bin/kf/sync_msg            | YES        | (r *Client) SyncMsg             | NICEXAI    |
-|   发送消息        | POST     | /cgi-bin/kf/send_msg            | YES        | (r *Client) SendMsg             | NICEXAI    |
-|   发送事件响应消息 | POST     | /cgi-bin/kf/send_msg_on_event   | YES        | (r *Client) SendMsgOnEvent      | NICEXAI    |
-
-### 升级服务配置
-
-[官方文档](https://open.work.weixin.qq.com/api/doc/90001/90143/94702)
-
-|       名称                | 请求方式  | URL                                               | 是否已实现 | 使用方法                            |贡献者       |
-| :--------------:         | -------- | :-------------------------------------------------| ---------- | -------------------------------  |------------|
-| 获取配置的专员与客户群       | POST     | /cgi-bin/kf/customer/get_upgrade_service_config   | YES        | (r *Client) UpgradeServiceConfig | NICEXAI    |
-| 为客户升级为专员或客户群服务  | POST     | /cgi-bin/kf/customer/upgrade_service              | YES        | (r *Client) UpgradeService       | NICEXAI    |
-| 为客户取消推荐             | POST     | /cgi-bin/kf/customer/cancel_upgrade_service       | YES        | (r *Client) UpgradeServiceCancel  | NICEXAI    |
-
-### 其他基础信息获取
-
-[官方文档](https://open.work.weixin.qq.com/api/doc/90001/90143/95148)
-
-|       名称            | 请求方式  | URL                                     | 是否已实现   | 使用方法                            | 贡献者       |
-| :--------------:     | -------- | :---------------------------------------| ---------- | -------------------------------   |------------|
-| 获取客户基础信息        | POST     | /cgi-bin/kf/customer/batchget           | YES        | (r *Client) CustomerBatchGet      | NICEXAI    |
-| 获取视频号绑定状态      | GET      |  /cgi-bin/kf/get_corp_qualification      | YES        | (r *Client) GetCorpQualification  | NICEXAI    |
-
-### 客户联系
-[官方文档](https://developer.work.weixin.qq.com/document/path/92132/92133/92228)
-
-|            名称            | 请求方式  | URL                                                          | 是否已实现   | 使用方法                            | 贡献者      |
-|:------------------------:| -------- |:-------------------------------------------------------------| ---------- | -------------------------------   |----------|
-|       获取「联系客户统计」数据       | POST     | /cgi-bin/externalcontact/get_user_behavior_data              | YES        | (r *Client) GetUserBehaviorData      | MARKWANG |
-| 获取「群聊数据统计」数据 (按群主聚合的方式)  | POST      | /cgi-bin/externalcontact/groupchat/statistic                 | YES        | (r *Client) GetGroupChatStat  | MARKWANG  |
-| 获取「群聊数据统计」数据 (按自然日聚合的方式) | POST      | /cgi-bin/externalcontact/groupchat/statistic_group_by_day    | YES        | (r *Client) GetGroupChatStatByDay  | MARKWANG  |
-|      配置客户联系「联系我」方式       | POST      | /cgi-bin/externalcontact/add_contact_way                     | YES        | (r *Client) AddContactWay  | MARKWANG  |
-|     获取企业已配置的「联系我」方式      | POST      | /cgi-bin/externalcontact/get_contact_way                     | YES        | (r *Client) GetContactWay  | MARKWANG  |
-|     更新企业已配置的「联系我」方式      | POST      | /cgi-bin/externalcontact/update_contact_way                  | YES        | (r *Client) UpdateContactWay  | MARKWANG  |
-|     获取企业已配置的「联系我」列表      | POST      | /cgi-bin/externalcontact/list_contact_way                    | YES        | (r *Client) ListContactWay  | MARKWANG  |
-|     删除企业已配置的「联系我」方式      | POST      | /cgi-bin/externalcontact/del_contact_way                     | YES        | (r *Client) DelContactWay  | MARKWANG  |
-|          创建企业群发          | POST      | /cgi-bin/externalcontact/add_msg_template                    | YES        | (r *Client) AddMsgTemplate  | MARKWANG  |
-|          获取群发记录列表          | POST      | /cgi-bin/externalcontact/get_groupmsg_list_v2                | YES        | (r *Client) GetGroupMsgListV2  | MARKWANG  |
-|          获取群发成员发送任务列表          | POST      | /cgi-bin/externalcontact/get_groupmsg_task                   | YES        | (r *Client) GetGroupMsgTask  | MARKWANG  |
-|          获取企业群发成员执行结果          | POST      | /cgi-bin/externalcontact/get_groupmsg_send_result            | YES        | (r *Client) GetGroupMsgSendResult  | MARKWANG  |
-|          发送新客户欢迎语          | POST      | /cgi-bin/externalcontact/send_welcome_msg                    | YES        | (r *Client) SendWelcomeMsg  | MARKWANG  |
-|          添加入群欢迎语素材          | POST      | /cgi-bin/externalcontact/group_welcome_template/add          | YES        | (r *Client) AddGroupWelcomeTemplate  | MARKWANG  |
-|          编辑入群欢迎语素材          | POST      | /cgi-bin/externalcontact/group_welcome_template/edit         | YES        | (r *Client) EditGroupWelcomeTemplate  | MARKWANG  |
-|          获取入群欢迎语素材          | POST      | /cgi-bin/externalcontact/group_welcome_template/get          | YES        | (r *Client) GetGroupWelcomeTemplate  | MARKWANG  |
-|          删除入群欢迎语素材          | POST      | /cgi-bin/externalcontact/group_welcome_template/del          | YES        | (r *Client) DelGroupWelcomeTemplate  | MARKWANG  |
-
-## 通讯录管理
-[官方文档](https://developer.work.weixin.qq.com/document/path/90193)
-
-### 部门管理
-
-|    名称     | 请求方式 | URL                                     | 是否已实现   | 使用方法                            | 贡献者      |
-|:---------:|------|:----------------------------------------| ---------- | -------------------------------   |----------|
-| 获取子部门ID列表 | GET  | /cgi-bin/department/simplelist          | YES        | (r *Client) DepartmentSimpleList| MARKWANG |
-| 获取部门列表 | GET  | /cgi-bin/department/list                 | YES        | (r *Client) DepartmentList| just5325, ourines |
-|  获取部门成员   | GET | /cgi-bin/user/simplelist                | YES        | (r *Client) UserSimpleList  | MARKWANG  |
-|  获取成员ID列表   | Post | /cgi-bin/user/list_id                | YES        | (r *Client) UserListId  | MARKWANG  |
-
-
-
-## 素材管理
-[官方文档](https://developer.work.weixin.qq.com/document/path/91054)
-
-|    名称     | 请求方式 | URL                                     | 是否已实现   | 使用方法                            | 贡献者      |
-|:---------:|------|:----------------------------------------| ---------- | -------------------------------   |----------|
-| 上传图片 | POST  | /cgi-bin/media/uploadimg          | YES        | (r *Client) UploadImg| MARKWANG |
-
-### 成员管理
-
-| 名称     | 请求方式 | URL               | 是否已实现 | 使用方法            | 贡献者   |
-| -------- | -------- | ----------------- | ---------- | ------------------- | -------- |
-| 读取成员 | GET      | /cgi-bin/user/get | YES        | (r *Client) UserGet | chcthink |
-
-
-## 群机器人
-
-[官方文档](https://developer.work.weixin.qq.com/document/path/91770)
-
-| 名称             | 请求方式 | URL                   | 是否已实现 | 使用方法                   | 贡献者   |
-| ---------------- | -------- | --------------------- | ---------- | -------------------------- | -------- |
-| 群机器人发送消息 | POST     | /cgi-bin/webhook/send | YES        | (r *Client) RobotBroadcast | chcthink |
-
-## 打卡
-
-[官方文档](https://developer.work.weixin.qq.com/document/path/96497)
-
-| 名称       | 请求方式 | URL                   | 是否已实现 | 使用方法                   | 贡献者     |
-|----------| -------- | --------------------- | ---------- | -------------------------- |---------|
-| 获取打卡日报数据 | POST     |  /cgi-bin/checkin/getcheckin_daydata | YES        | (r *Client) GetDayData | Thinker |
-| 获取打卡月报数据 | POST     |  /cgi-bin/checkin/getcheckin_monthdata | YES        | (r *Client) GetMonthData | Thinker |
-
-## 应用管理
-TODO

doc/api/wxpay.md

@@ -1,3 +0,0 @@
-# 微信支付
-
-TODO

domain/openapi/mgnt.go

@@ -1,36 +0,0 @@
-package openapi
-
-import "github.com/silenceper/wechat/v2/util"
-
-// GetAPIQuotaParams 查询 API 调用额度参数
-type GetAPIQuotaParams struct {
-	CgiPath string `json:"cgi_path"` // api 的请求地址，例如"/cgi-bin/message/custom/send";不要前缀“https://api.weixin.qq.com” ，也不要漏了"/",否则都会 76003 的报错
-}
-
-// APIQuota API 调用额度
-type APIQuota struct {
-	util.CommonError
-	Quota struct {
-		DailyLimit int64 `json:"daily_limit"` // 当天该账号可调用该接口的次数
-		Used       int64 `json:"used"`        // 当天已经调用的次数
-		Remain     int64 `json:"remain"`      // 当天剩余调用次数
-	} `json:"quota"` // 详情
-}
-
-// GetRidInfoParams 查询 rid 信息参数
-type GetRidInfoParams struct {
-	Rid string `json:"rid"` // 调用接口报错返回的 rid
-}
-
-// RidInfo rid 信息
-type RidInfo struct {
-	util.CommonError
-	Request struct {
-		InvokeTime   int64  `json:"invoke_time"`   // 发起请求的时间戳
-		CostInMs     int64  `json:"cost_in_ms"`    // 请求毫秒级耗时
-		RequestURL   string `json:"request_url"`   // 请求的 URL 参数
-		RequestBody  string `json:"request_body"`  // post 请求的请求参数
-		ResponseBody string `json:"response_body"` // 接口请求返回参数
-		ClientIP     string `json:"client_ip"`     // 接口请求的客户端 ip
-	} `json:"request"` // 该 rid 对应的请求详情
-}

examples/beego/beego.go

@@ -0,0 +1,45 @@
+package main
+
+import (
+	"fmt"
+
+	"github.com/astaxie/beego"
+	"github.com/astaxie/beego/context"
+	"github.com/silenceper/wechat"
+	"github.com/silenceper/wechat/message"
+)
+
+func hello(ctx *context.Context) {
+	//配置微信参数
+	config := &wechat.Config{
+		AppID:          "your app id",
+		AppSecret:      "your app secret",
+		Token:          "your token",
+		EncodingAESKey: "your encoding aes key",
+	}
+	wc := wechat.NewWechat(config)
+
+	// 传入request和responseWriter
+	server := wc.GetServer(ctx.Request, ctx.ResponseWriter)
+	//设置接收消息的处理方法
+	server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
+
+		//回复消息：演示回复用户发送的消息
+		text := message.NewText(msg.Content)
+		return &message.Reply{MsgType: message.MsgTypeText, MsgData: text}
+	})
+
+	//处理消息接收以及回复
+	err := server.Serve()
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+	//发送回复的消息
+	server.Send()
+}
+
+func main() {
+	beego.Any("/", hello)
+	beego.Run(":8001")
+}

examples/gin/gin.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"fmt"
+
+	"github.com/gin-gonic/gin"
+	"github.com/silenceper/wechat"
+	"github.com/silenceper/wechat/message"
+)
+
+func main() {
+	router := gin.Default()
+
+	router.Any("/", hello)
+	router.Run(":8001")
+}
+
+func hello(c *gin.Context) {
+
+	//配置微信参数
+	config := &wechat.Config{
+		AppID:          "your app id",
+		AppSecret:      "your app secret",
+		Token:          "your token",
+		EncodingAESKey: "your encoding aes key",
+	}
+	wc := wechat.NewWechat(config)
+
+	// 传入request和responseWriter
+	server := wc.GetServer(c.Request, c.Writer)
+	//设置接收消息的处理方法
+	server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
+
+		//回复消息：演示回复用户发送的消息
+		text := message.NewText(msg.Content)
+		return &message.Reply{MsgType: message.MsgTypeText, MsgData: text}
+	})
+
+	//处理消息接收以及回复
+	err := server.Serve()
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+	//发送回复的消息
+	server.Send()
+}

examples/http/http.go

@@ -0,0 +1,48 @@
+package main
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/silenceper/wechat"
+	"github.com/silenceper/wechat/message"
+)
+
+func hello(rw http.ResponseWriter, req *http.Request) {
+
+	//配置微信参数
+	config := &wechat.Config{
+		AppID:          "your app id",
+		AppSecret:      "your app secret",
+		Token:          "your token",
+		EncodingAESKey: "your encoding aes key",
+	}
+	wc := wechat.NewWechat(config)
+
+	// 传入request和responseWriter
+	server := wc.GetServer(req, rw)
+	//设置接收消息的处理方法
+	server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
+
+		//回复消息：演示回复用户发送的消息
+		text := message.NewText(msg.Content)
+		return &message.Reply{MsgType: message.MsgTypeText, MsgData: text}
+	})
+
+	//处理消息接收以及回复
+	err := server.Serve()
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+	//发送回复的消息
+	server.Send()
+}
+
+func main() {
+	http.HandleFunc("/", hello)
+	err := http.ListenAndServe(":8001", nil)
+	if err != nil {
+		fmt.Printf("start server error , err=%v", err)
+	}
+}

go.mod

@@ -1,14 +1,13 @@
-module github.com/silenceper/wechat/v2
+module github.com/silenceper/wechat
 
-go 1.16
+go 1.13
 
 require (
-	github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d
+	github.com/astaxie/beego v1.7.1
+	github.com/bradfitz/gomemcache v0.0.0-20190913173617-a41fca850d0b
 	github.com/fatih/structs v1.1.0
-	github.com/sirupsen/logrus v1.9.0
-	github.com/spf13/cast v1.4.1
-	github.com/stretchr/testify v1.7.1
-	github.com/tidwall/gjson v1.14.1
-	golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d
-	gopkg.in/h2non/gock.v1 v1.1.2
+	github.com/gin-gonic/gin v1.6.3
+	github.com/gomodule/redigo v1.8.1 // indirect
+	github.com/spf13/cast v1.3.1
+	golang.org/x/crypto v0.0.0-20200510223506-06a226fb4e37
 )

go.sum

@@ -1,45 +1,75 @@
-github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d h1:pVrfxiGfwelyab6n21ZBkbkmbevaf+WvMIiR7sr97hw=
-github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d/go.mod h1:H0wQNHz2YrLsuXOZozoeDmnHXkNCRmMW0gwFWDfEZDA=
+github.com/astaxie/beego v1.7.1 h1:TuqX4F9e3ujVEycudgWrwUj11WMppLZyunJKIBoxTFw=
+github.com/astaxie/beego v1.7.1/go.mod h1:0R4++1tUqERR0WYFWdfkcrsyoVBCG4DgpDGokT3yb+U=
+github.com/bradfitz/gomemcache v0.0.0-20190913173617-a41fca850d0b h1:L/QXpzIa3pOvUGt1D1lA5KjYhPBAN/3iWdP7xeFS9F0=
+github.com/bradfitz/gomemcache v0.0.0-20190913173617-a41fca850d0b/go.mod h1:H0wQNHz2YrLsuXOZozoeDmnHXkNCRmMW0gwFWDfEZDA=
+github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/fatih/structs v1.1.0 h1:Q7juDM0QtcnhCpeyLGQKyg4TOIghuNXrkL32pHAUMxo=
 github.com/fatih/structs v1.1.0/go.mod h1:9NiDSp5zOcgEDl+j00MP/WkGVPOlPRLejGD8Ga6PJ7M=
-github.com/h2non/parth v0.0.0-20190131123155-b4df798d6542 h1:2VTzZjLZBgl62/EtslCrtky5vbi9dd7HrQPQIx6wqiw=
-github.com/h2non/parth v0.0.0-20190131123155-b4df798d6542/go.mod h1:Ow0tF8D4Kplbc8s8sSb3V2oUCygFHVp8gC3Dn6U4MNI=
-github.com/nbio/st v0.0.0-20140626010706-e9e8d9816f32 h1:W6apQkHrMkS0Muv8G/TipAy/FJl/rCYT0+EuS8+Z0z4=
-github.com/nbio/st v0.0.0-20140626010706-e9e8d9816f32/go.mod h1:9wM+0iRr9ahx58uYLpLIr5fm8diHn0JbqRycJi6w0Ms=
+github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
+github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gin-gonic/gin v1.6.3 h1:ahKqKTFpO5KTPHxWZjEdPScmYaGtLo8Y4DMHoEsnp14=
+github.com/gin-gonic/gin v1.6.3/go.mod h1:75u5sXoLsGZoRN5Sgbi1eraJ4GU3++wFwWzhwvtwp4M=
+github.com/go-playground/assert/v2 v2.0.1 h1:MsBgLAaY856+nPRTKrp3/OZK38U/wa0CcBYNjji3q3A=
+github.com/go-playground/assert/v2 v2.0.1/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.13.0 h1:HyWk6mgj5qFqCT5fjGBuRArbVDfE4hi8+e8ceBS/t7Q=
+github.com/go-playground/locales v0.13.0/go.mod h1:taPMhCMXrRLJO55olJkUXHZBHCxTMfnGwq/HNwmWNS8=
+github.com/go-playground/universal-translator v0.17.0 h1:icxd5fm+REJzpZx7ZfpaD876Lmtgy7VtROAbHHXk8no=
+github.com/go-playground/universal-translator v0.17.0/go.mod h1:UkSxE5sNxxRwHyU+Scu5vgOQjsIJAF8j9muTVoKLVtA=
+github.com/go-playground/validator/v10 v10.2.0 h1:KgJ0snyC2R9VXYN2rneOtQcw5aHQB1Vv0sFl1UcHBOY=
+github.com/go-playground/validator/v10 v10.2.0/go.mod h1:uOYAAleCW8F/7oMFd6aG0GOhaH6EGOAJShg8Id5JGkI=
+github.com/golang/protobuf v1.3.3 h1:gyjaxf+svBWX08ZjK86iN9geUJF0H6gp2IRKX6Nf6/I=
+github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw=
+github.com/gomodule/redigo v0.0.0-20200429221454-e14091dffc1b h1:58st9mvZD0VpNKVxG3QQqcEXatwcZQimIhRq/hQHRBU=
+github.com/gomodule/redigo v0.0.0-20200429221454-e14091dffc1b/go.mod h1:B4C85qUVwatsJoIUNIfCRsp7qO0iAmpGFZ4EELWSbC4=
+github.com/gomodule/redigo v1.8.1 h1:Abmo0bI7Xf0IhdIPc7HZQzZcShdnmxeoVuDDtIQp8N8=
+github.com/gomodule/redigo v1.8.1/go.mod h1:P9dn9mFrCBvWhGE1wpxx6fgq7BAeLBk+UUUzlpkBYO0=
+github.com/gomodule/redigo/redis v0.0.0-20200429221454-e14091dffc1b h1:XAV1CHPRk+MUwbuzYHrCgq7mVq0Z0kcKNilDF4A8yys=
+github.com/gomodule/redigo/redis v0.0.0-20200429221454-e14091dffc1b/go.mod h1:0zioC1ElIFjAFjnYHA9Y8oeU9SHff86XhZgs2tpx9SU=
+github.com/gomodule/redigo/redis v0.0.0-do-not-use/go.mod h1:DAjdM68BqtBsasI8YAQVRAOTlhDyI5EjYykQ4DBKY0I=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/json-iterator/go v1.1.9 h1:9yzud/Ht36ygwatGx56VwCZtlI/2AD15T1X2sjSuGns=
+github.com/json-iterator/go v1.1.9/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4=
+github.com/leodido/go-urn v1.2.0 h1:hpXL4XnriNwQ/ABnpepYM/1vCLWNDfUNts8dX3xTG6Y=
+github.com/leodido/go-urn v1.2.0/go.mod h1:+8+nEpDfqqsY+g338gtMEUOtuK+4dEMhiQEgxpxOKII=
+github.com/mattn/go-isatty v0.0.12 h1:wuysRhFDzyxgEmMf5xjvJ2M9dZoWAXNNr5LSBS7uHXY=
+github.com/mattn/go-isatty v0.0.12/go.mod h1:cbi8OIDigv2wuxKPP5vlRcQ1OAZbq2CE4Kysco4FUpU=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 h1:ZqeYNhU3OHLH3mGKHDcjJRFFRrJa6eAM5H+CtDdOsPc=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742 h1:Esafd1046DLDQ0W1YjYsBW+p8U2u7vzgW2SQVmlNazg=
+github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/sirupsen/logrus v1.9.0 h1:trlNQbNUG3OdDrDil03MCb1H2o9nJ1x4/5LYw7byDE0=
-github.com/sirupsen/logrus v1.9.0/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ=
-github.com/spf13/cast v1.4.1 h1:s0hze+J0196ZfEMTs80N7UlFt0BDuQ7Q+JDnHiMWKdA=
-github.com/spf13/cast v1.4.1/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE=
+github.com/spf13/cast v1.3.1 h1:nFm6S0SMdyzrzcmThSipiEubIDy8WEXKNZ0UOgiRpng=
+github.com/spf13/cast v1.3.1/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
-github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
-github.com/stretchr/testify v1.7.1 h1:5TQK59W5E3v0r2duFAb7P95B6hEeOyEnHRa8MjYSMTY=
-github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
-github.com/tidwall/gjson v1.14.1 h1:iymTbGkQBhveq21bEvAQ81I0LEBork8BFe1CUZXdyuo=
-github.com/tidwall/gjson v1.14.1/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
-github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
-github.com/tidwall/match v1.1.1/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM=
-github.com/tidwall/pretty v1.2.0 h1:RWIZEg2iJ8/g6fDDYzMpobmaoGh5OLl4AXtGUGPcqCs=
-github.com/tidwall/pretty v1.2.0/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
-golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d h1:sK3txAijHtOK88l68nt020reeT1ZdKLIYetKl95FzVY=
-golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
-golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
-golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 h1:0A+M6Uqn+Eje4kHMK80dtF3JCXC4ykBgQG4Fe06QRhQ=
-golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
-golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.4.0 h1:2E4SXV/wtOkTonXsotYi4li6zVWxYlZuYNCXe9XRJyk=
+github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
+github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
+github.com/ugorji/go v1.1.7 h1:/68gy2h+1mWMrwZFeD1kQialdSzAb432dtpeJ42ovdo=
+github.com/ugorji/go v1.1.7/go.mod h1:kZn38zHttfInRq0xu/PH0az30d+z6vm202qpg1oXVMw=
+github.com/ugorji/go/codec v1.1.7 h1:2SvQaVZ1ouYrrKKwoSk2pzd4A9evlKJb9oTL+OaLUSs=
+github.com/ugorji/go/codec v1.1.7/go.mod h1:Ax+UKWsSmolVDwsd+7N3ZtXu+yMGCf907BLYF3GoBXY=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2 h1:VklqNMn3ovrHsnt90PveolxSbWFaJdECFbxSq0Mqo2M=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20200510223506-06a226fb4e37 h1:cg5LA/zNPRzIXIWSCxQW10Rvpy94aQh3LT/ShoCpkHw=
+golang.org/x/crypto v0.0.0-20200510223506-06a226fb4e37/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a h1:1BGLXjeY4akVXGgbC9HugT3Jv3hCI0z56oJR5vAMgBU=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200116001909-b77594299b42 h1:vEOn+mP2zCOVzKckCZy6YsCtDblrpj/w7B9nxGNELpg=
+golang.org/x/sys v0.0.0-20200116001909-b77594299b42/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/h2non/gock.v1 v1.1.2 h1:jBbHXgGBK/AoPVfJh5x4r/WxIrElvbLel8TCZkkZJoY=
-gopkg.in/h2non/gock.v1 v1.1.2/go.mod h1:n7UGz/ckNChHiK05rDoiC4MYSunEC/lyaUm2WWaDva0=
-gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c h1:dUUwHk2QECo/6vqA44rthZ8ie2QXMNeKRTHCNY2nXvo=
-gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v2 v2.2.2 h1:ZCJp+EgiOT7lHqUV2J862kp8Qj64Jo6az82+3Td9dZw=
+gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v2 v2.2.8 h1:obN1ZagJSUGI0Ek/LBmuj4SNLPfIny3KsKFopxRdj10=
+gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=

internal/openapi/mgnt.go

@@ -1,127 +0,0 @@
-package openapi
-
-import (
-	"errors"
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/domain/openapi"
-	mpContext "github.com/silenceper/wechat/v2/miniprogram/context"
-	ocContext "github.com/silenceper/wechat/v2/officialaccount/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	clearQuotaURL            = "https://api.weixin.qq.com/cgi-bin/clear_quota"       // 重置API调用次数
-	getAPIQuotaURL           = "https://api.weixin.qq.com/cgi-bin/openapi/quota/get" // 查询API调用额度
-	getRidInfoURL            = "https://api.weixin.qq.com/cgi-bin/openapi/rid/get"   // 查询rid信息
-	clearQuotaByAppSecretURL = "https://api.weixin.qq.com/cgi-bin/clear_quota/v2"    // 使用AppSecret重置 API 调用次数
-)
-
-// OpenAPI openApi管理
-type OpenAPI struct {
-	ctx interface{}
-}
-
-// NewOpenAPI 实例化
-func NewOpenAPI(ctx interface{}) *OpenAPI {
-	return &OpenAPI{ctx: ctx}
-}
-
-// ClearQuota 重置API调用次数
-// https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/clearQuota.html
-func (o *OpenAPI) ClearQuota() error {
-	appID, _, err := o.getAppIDAndSecret()
-	if err != nil {
-		return err
-	}
-
-	var payload = struct {
-		AppID string `json:"appid"`
-	}{
-		AppID: appID,
-	}
-	res, err := o.doPostRequest(clearQuotaURL, payload)
-	if err != nil {
-		return err
-	}
-
-	return util.DecodeWithCommonError(res, "ClearQuota")
-}
-
-// GetAPIQuota 查询API调用额度
-// https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/getApiQuota.html
-func (o *OpenAPI) GetAPIQuota(params openapi.GetAPIQuotaParams) (quota openapi.APIQuota, err error) {
-	res, err := o.doPostRequest(getAPIQuotaURL, params)
-	if err != nil {
-		return
-	}
-
-	err = util.DecodeWithError(res, &quota, "GetAPIQuota")
-	return
-}
-
-// GetRidInfo 查询rid信息
-// https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/getRidInfo.html
-func (o *OpenAPI) GetRidInfo(params openapi.GetRidInfoParams) (r openapi.RidInfo, err error) {
-	res, err := o.doPostRequest(getRidInfoURL, params)
-	if err != nil {
-		return
-	}
-
-	err = util.DecodeWithError(res, &r, "GetRidInfo")
-	return
-}
-
-// ClearQuotaByAppSecret 使用AppSecret重置 API 调用次数
-// https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/clearQuotaByAppSecret.html
-func (o *OpenAPI) ClearQuotaByAppSecret() error {
-	id, secret, err := o.getAppIDAndSecret()
-	if err != nil {
-		return err
-	}
-
-	uri := fmt.Sprintf("%s?appid=%s&appsecret=%s", clearQuotaByAppSecretURL, id, secret)
-	res, err := util.HTTPPost(uri, "")
-	if err != nil {
-		return err
-	}
-
-	return util.DecodeWithCommonError(res, "ClearQuotaByAppSecret")
-}
-
-// 获取 AppID 和 AppSecret
-func (o *OpenAPI) getAppIDAndSecret() (string, string, error) {
-	switch o.ctx.(type) {
-	case *mpContext.Context:
-		c := o.ctx.(*mpContext.Context)
-		return c.AppID, c.AppSecret, nil
-	case *ocContext.Context:
-		c := o.ctx.(*ocContext.Context)
-		return c.AppID, c.AppSecret, nil
-	default:
-		return "", "", errors.New("invalid context type")
-	}
-}
-
-// 获取 AccessToken
-func (o *OpenAPI) getAccessToken() (string, error) {
-	switch o.ctx.(type) {
-	case *mpContext.Context:
-		return o.ctx.(*mpContext.Context).GetAccessToken()
-	case *ocContext.Context:
-		return o.ctx.(*ocContext.Context).GetAccessToken()
-	default:
-		return "", errors.New("invalid context type")
-	}
-}
-
-// 创建 POST 请求
-func (o *OpenAPI) doPostRequest(uri string, payload interface{}) ([]byte, error) {
-	ak, err := o.getAccessToken()
-	if err != nil {
-		return nil, err
-	}
-
-	uri = fmt.Sprintf("%s?access_token=%s", uri, ak)
-	return util.PostJSON(uri, payload)
-}

js/js.go

@@ -0,0 +1,109 @@
+package js
+
+import (
+	"encoding/json"
+	"fmt"
+	"time"
+
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
+)
+
+const getTicketURL = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=%s&type=jsapi"
+
+// Js struct
+type Js struct {
+	*context.Context
+}
+
+// Config 返回给用户jssdk配置信息
+type Config struct {
+	AppID     string `json:"app_id"`
+	Timestamp int64  `json:"timestamp"`
+	NonceStr  string `json:"nonce_str"`
+	Signature string `json:"signature"`
+}
+
+// resTicket 请求jsapi_tikcet返回结果
+type resTicket struct {
+	util.CommonError
+
+	Ticket    string `json:"ticket"`
+	ExpiresIn int64  `json:"expires_in"`
+}
+
+//NewJs init
+func NewJs(context *context.Context) *Js {
+	js := new(Js)
+	js.Context = context
+	return js
+}
+
+//GetConfig 获取jssdk需要的配置参数
+//uri 为当前网页地址
+func (js *Js) GetConfig(uri string) (config *Config, err error) {
+	config = new(Config)
+	var ticketStr string
+	ticketStr, err = js.GetTicket()
+	if err != nil {
+		return
+	}
+
+	nonceStr := util.RandomStr(16)
+	timestamp := util.GetCurrTs()
+	str := fmt.Sprintf("jsapi_ticket=%s&noncestr=%s&timestamp=%d&url=%s", ticketStr, nonceStr, timestamp, uri)
+	sigStr := util.Signature(str)
+
+	config.AppID = js.AppID
+	config.NonceStr = nonceStr
+	config.Timestamp = timestamp
+	config.Signature = sigStr
+	return
+}
+
+//GetTicket 获取jsapi_ticket
+func (js *Js) GetTicket() (ticketStr string, err error) {
+	js.GetJsAPITicketLock().Lock()
+	defer js.GetJsAPITicketLock().Unlock()
+
+	//先从cache中取
+	jsAPITicketCacheKey := fmt.Sprintf("jsapi_ticket_%s", js.AppID)
+	val := js.Cache.Get(jsAPITicketCacheKey)
+	if val != nil {
+		ticketStr = val.(string)
+		return
+	}
+	var ticket resTicket
+	ticket, err = js.getTicketFromServer()
+	if err != nil {
+		return
+	}
+	ticketStr = ticket.Ticket
+	return
+}
+
+//getTicketFromServer 强制从服务器中获取ticket
+func (js *Js) getTicketFromServer() (ticket resTicket, err error) {
+	var accessToken string
+	accessToken, err = js.GetAccessToken()
+	if err != nil {
+		return
+	}
+
+	var response []byte
+	url := fmt.Sprintf(getTicketURL, accessToken)
+	response, err = util.HTTPGet(url)
+	err = json.Unmarshal(response, &ticket)
+	if err != nil {
+		return
+	}
+	if ticket.ErrCode != 0 {
+		err = fmt.Errorf("getTicket Error : errcode=%d , errmsg=%s", ticket.ErrCode, ticket.ErrMsg)
+		return
+	}
+
+	jsAPITicketCacheKey := fmt.Sprintf("jsapi_ticket_%s", js.AppID)
+	expires := ticket.ExpiresIn - 1500
+	err = js.Cache.Set(jsAPITicketCacheKey, ticket.Ticket, time.Duration(expires)*time.Second)
+	return
+}

material/material.go

@@ -0,0 +1,218 @@
+package material
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	addNewsURL     = "https://api.weixin.qq.com/cgi-bin/material/add_news"
+	addMaterialURL = "https://api.weixin.qq.com/cgi-bin/material/add_material"
+	delMaterialURL = "https://api.weixin.qq.com/cgi-bin/material/del_material"
+	getMaterialURL = "https://api.weixin.qq.com/cgi-bin/material/get_material"
+)
+
+//Material 素材管理
+type Material struct {
+	*context.Context
+}
+
+//NewMaterial init
+func NewMaterial(context *context.Context) *Material {
+	material := new(Material)
+	material.Context = context
+	return material
+}
+
+//Article 永久图文素材
+type Article struct {
+	Title            string `json:"title"`
+	ThumbMediaID     string `json:"thumb_media_id"`
+	ThumbURL         string `json:"thumb_url"`
+	Author           string `json:"author"`
+	Digest           string `json:"digest"`
+	ShowCoverPic     int    `json:"show_cover_pic"`
+	Content          string `json:"content"`
+	ContentSourceURL string `json:"content_source_url"`
+	URL              string `json:"url"`
+	DownURL          string `json:"down_url"`
+}
+
+// GetNews 获取/下载永久素材
+func (material *Material) GetNews(id string) ([]*Article, error) {
+	accessToken, err := material.GetAccessToken()
+	if err != nil {
+		return nil, err
+	}
+	uri := fmt.Sprintf("%s?access_token=%s", getMaterialURL, accessToken)
+
+	var req struct {
+		MediaID string `json:"media_id"`
+	}
+	req.MediaID = id
+	responseBytes, err := util.PostJSON(uri, req)
+
+	var res struct {
+		NewsItem []*Article `json:"news_item"`
+	}
+	err = json.Unmarshal(responseBytes, &res)
+	if err != nil {
+		return nil, err
+	}
+
+	return res.NewsItem, nil
+}
+
+//reqArticles 永久性图文素材请求信息
+type reqArticles struct {
+	Articles []*Article `json:"articles"`
+}
+
+//resArticles 永久性图文素材返回结果
+type resArticles struct {
+	util.CommonError
+
+	MediaID string `json:"media_id"`
+}
+
+//AddNews 新增永久图文素材
+func (material *Material) AddNews(articles []*Article) (mediaID string, err error) {
+	req := &reqArticles{articles}
+
+	var accessToken string
+	accessToken, err = material.GetAccessToken()
+	if err != nil {
+		return
+	}
+
+	uri := fmt.Sprintf("%s?access_token=%s", addNewsURL, accessToken)
+	responseBytes, err := util.PostJSON(uri, req)
+	var res resArticles
+	err = json.Unmarshal(responseBytes, &res)
+	if err != nil {
+		return
+	}
+	mediaID = res.MediaID
+	return
+}
+
+//resAddMaterial 永久性素材上传返回的结果
+type resAddMaterial struct {
+	util.CommonError
+
+	MediaID string `json:"media_id"`
+	URL     string `json:"url"`
+}
+
+//AddMaterial 上传永久性素材（处理视频需要单独上传）
+func (material *Material) AddMaterial(mediaType MediaType, filename string) (mediaID string, url string, err error) {
+	if mediaType == MediaTypeVideo {
+		err = errors.New("永久视频素材上传使用 AddVideo 方法")
+	}
+	var accessToken string
+	accessToken, err = material.GetAccessToken()
+	if err != nil {
+		return
+	}
+
+	uri := fmt.Sprintf("%s?access_token=%s&type=%s", addMaterialURL, accessToken, mediaType)
+	var response []byte
+	response, err = util.PostFile("media", filename, uri)
+	if err != nil {
+		return
+	}
+	var resMaterial resAddMaterial
+	err = json.Unmarshal(response, &resMaterial)
+	if err != nil {
+		return
+	}
+	if resMaterial.ErrCode != 0 {
+		err = fmt.Errorf("AddMaterial error : errcode=%v , errmsg=%v", resMaterial.ErrCode, resMaterial.ErrMsg)
+		return
+	}
+	mediaID = resMaterial.MediaID
+	url = resMaterial.URL
+	return
+}
+
+type reqVideo struct {
+	Title        string `json:"title"`
+	Introduction string `json:"introduction"`
+}
+
+//AddVideo 永久视频素材文件上传
+func (material *Material) AddVideo(filename, title, introduction string) (mediaID string, url string, err error) {
+	var accessToken string
+	accessToken, err = material.GetAccessToken()
+	if err != nil {
+		return
+	}
+
+	uri := fmt.Sprintf("%s?access_token=%s&type=video", addMaterialURL, accessToken)
+
+	videoDesc := &reqVideo{
+		Title:        title,
+		Introduction: introduction,
+	}
+	var fieldValue []byte
+	fieldValue, err = json.Marshal(videoDesc)
+	if err != nil {
+		return
+	}
+
+	fields := []util.MultipartFormField{
+		{
+			IsFile:    true,
+			Fieldname: "media",
+			Filename:  filename,
+		},
+		{
+			IsFile:    false,
+			Fieldname: "description",
+			Value:     fieldValue,
+		},
+	}
+
+	var response []byte
+	response, err = util.PostMultipartForm(fields, uri)
+	if err != nil {
+		return
+	}
+
+	var resMaterial resAddMaterial
+	err = json.Unmarshal(response, &resMaterial)
+	if err != nil {
+		return
+	}
+	if resMaterial.ErrCode != 0 {
+		err = fmt.Errorf("AddMaterial error : errcode=%v , errmsg=%v", resMaterial.ErrCode, resMaterial.ErrMsg)
+		return
+	}
+	mediaID = resMaterial.MediaID
+	url = resMaterial.URL
+	return
+}
+
+type reqDeleteMaterial struct {
+	MediaID string `json:"media_id"`
+}
+
+//DeleteMaterial 删除永久素材
+func (material *Material) DeleteMaterial(mediaID string) error {
+	accessToken, err := material.GetAccessToken()
+	if err != nil {
+		return err
+	}
+
+	uri := fmt.Sprintf("%s?access_token=%s", delMaterialURL, accessToken)
+	response, err := util.PostJSON(uri, reqDeleteMaterial{mediaID})
+	if err != nil {
+		return err
+	}
+
+	return util.DecodeWithCommonError(response, "DeleteMaterial")
+}

material/media.go

@@ -3,23 +3,22 @@ package material
 import (
 	"encoding/json"
 	"fmt"
-	"io"
 
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
-// MediaType 媒体文件类型
+//MediaType 媒体文件类型
 type MediaType string
 
 const (
-	// MediaTypeImage 媒体文件:图片
+	//MediaTypeImage 媒体文件:图片
 	MediaTypeImage MediaType = "image"
-	// MediaTypeVoice 媒体文件:声音
-	MediaTypeVoice MediaType = "voice"
-	// MediaTypeVideo 媒体文件:视频
-	MediaTypeVideo MediaType = "video"
-	// MediaTypeThumb 媒体文件:缩略图
-	MediaTypeThumb MediaType = "thumb"
+	//MediaTypeVoice 媒体文件:声音
+	MediaTypeVoice = "voice"
+	//MediaTypeVideo 媒体文件:视频
+	MediaTypeVideo = "video"
+	//MediaTypeThumb 媒体文件:缩略图
+	MediaTypeThumb = "thumb"
 )
 
 const (
@@ -28,7 +27,7 @@ const (
 	mediaGetURL         = "https://api.weixin.qq.com/cgi-bin/media/get"
 )
 
-// Media 临时素材上传返回信息
+//Media 临时素材上传返回信息
 type Media struct {
 	util.CommonError
 
@@ -38,7 +37,7 @@ type Media struct {
 	CreatedAt    int64     `json:"created_at"`
 }
 
-// MediaUpload 临时素材上传
+//MediaUpload 临时素材上传
 func (material *Material) MediaUpload(mediaType MediaType, filename string) (media Media, err error) {
 	var accessToken string
 	accessToken, err = material.GetAccessToken()
@@ -63,40 +62,8 @@ func (material *Material) MediaUpload(mediaType MediaType, filename string) (med
 	return
 }
 
-// MediaUploadFromReader 临时素材上传
-func (material *Material) MediaUploadFromReader(mediaType MediaType, filename string, reader io.Reader) (media Media, err error) {
-	var accessToken string
-	accessToken, err = material.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf("%s?access_token=%s&type=%s", mediaUploadURL, accessToken, mediaType)
-
-	var byteData []byte
-	byteData, err = io.ReadAll(reader)
-	if err != nil {
-		return
-	}
-
-	var response []byte
-	response, err = util.PostFileByStream("media", filename, uri, byteData)
-	if err != nil {
-		return
-	}
-	err = json.Unmarshal(response, &media)
-	if err != nil {
-		return
-	}
-	if media.ErrCode != 0 {
-		err = fmt.Errorf("MediaUpload error : errcode=%v , errmsg=%v", media.ErrCode, media.ErrMsg)
-		return
-	}
-	return
-}
-
-// GetMediaURL 返回临时素材的下载地址供用户自己处理
-// NOTICE: URL 不可公开，因为含access_token 需要立即另存文件
+//GetMediaURL 返回临时素材的下载地址供用户自己处理
+//NOTICE: URL 不可公开，因为含access_token 需要立即另存文件
 func (material *Material) GetMediaURL(mediaID string) (mediaURL string, err error) {
 	var accessToken string
 	accessToken, err = material.GetAccessToken()
@@ -107,14 +74,14 @@ func (material *Material) GetMediaURL(mediaID string) (mediaURL string, err erro
 	return
 }
 
-// resMediaImage 图片上传返回结果
+//resMediaImage 图片上传返回结果
 type resMediaImage struct {
 	util.CommonError
 
 	URL string `json:"url"`
 }
 
-// ImageUpload 图片上传
+//ImageUpload 图片上传
 func (material *Material) ImageUpload(filename string) (url string, err error) {
 	var accessToken string
 	accessToken, err = material.GetAccessToken()
@@ -139,4 +106,5 @@ func (material *Material) ImageUpload(filename string) (url string, err error) {
 	}
 	url = image.URL
 	return
+
 }

menu/button.go

@@ -0,0 +1,143 @@
+package menu
+
+//Button 菜单按钮
+type Button struct {
+	Type       string    `json:"type,omitempty"`
+	Name       string    `json:"name,omitempty"`
+	Key        string    `json:"key,omitempty"`
+	URL        string    `json:"url,omitempty"`
+	MediaID    string    `json:"media_id,omitempty"`
+	AppID      string    `json:"appid,omitempty"`
+	PagePath   string    `json:"pagepath,omitempty"`
+	SubButtons []*Button `json:"sub_button,omitempty"`
+}
+
+//SetSubButton 设置二级菜单
+func (btn *Button) SetSubButton(name string, subButtons []*Button) {
+	btn.Name = name
+	btn.SubButtons = subButtons
+	btn.Type = ""
+	btn.Key = ""
+	btn.URL = ""
+	btn.MediaID = ""
+}
+
+//SetClickButton btn 为click类型
+func (btn *Button) SetClickButton(name, key string) {
+	btn.Type = "click"
+	btn.Name = name
+	btn.Key = key
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+//SetViewButton view类型
+func (btn *Button) SetViewButton(name, url string) {
+	btn.Type = "view"
+	btn.Name = name
+	btn.URL = url
+	btn.Key = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+// SetScanCodePushButton 扫码推事件
+func (btn *Button) SetScanCodePushButton(name, key string) {
+	btn.Type = "scancode_push"
+	btn.Name = name
+	btn.Key = key
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+//SetScanCodeWaitMsgButton 设置 扫码推事件且弹出"消息接收中"提示框
+func (btn *Button) SetScanCodeWaitMsgButton(name, key string) {
+	btn.Type = "scancode_waitmsg"
+	btn.Name = name
+	btn.Key = key
+
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+//SetPicSysPhotoButton 设置弹出系统拍照发图按钮
+func (btn *Button) SetPicSysPhotoButton(name, key string) {
+	btn.Type = "pic_sysphoto"
+	btn.Name = name
+	btn.Key = key
+
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+//SetPicPhotoOrAlbumButton 设置弹出拍照或者相册发图类型按钮
+func (btn *Button) SetPicPhotoOrAlbumButton(name, key string) {
+	btn.Type = "pic_photo_or_album"
+	btn.Name = name
+	btn.Key = key
+
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+// SetPicWeixinButton 设置弹出微信相册发图器类型按钮
+func (btn *Button) SetPicWeixinButton(name, key string) {
+	btn.Type = "pic_weixin"
+	btn.Name = name
+	btn.Key = key
+
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+// SetLocationSelectButton 设置 弹出地理位置选择器 类型按钮
+func (btn *Button) SetLocationSelectButton(name, key string) {
+	btn.Type = "location_select"
+	btn.Name = name
+	btn.Key = key
+
+	btn.URL = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}
+
+//SetMediaIDButton  设置 下发消息(除文本消息) 类型按钮
+func (btn *Button) SetMediaIDButton(name, mediaID string) {
+	btn.Type = "media_id"
+	btn.Name = name
+	btn.MediaID = mediaID
+
+	btn.Key = ""
+	btn.URL = ""
+	btn.SubButtons = nil
+}
+
+//SetViewLimitedButton  设置 跳转图文消息URL 类型按钮
+func (btn *Button) SetViewLimitedButton(name, mediaID string) {
+	btn.Type = "view_limited"
+	btn.Name = name
+	btn.MediaID = mediaID
+
+	btn.Key = ""
+	btn.URL = ""
+	btn.SubButtons = nil
+}
+
+//SetMiniprogramButton  设置 跳转小程序 类型按钮 (公众号后台必须已经关联小程序)
+func (btn *Button) SetMiniprogramButton(name, url, appID, pagePath string) {
+	btn.Type = "miniprogram"
+	btn.Name = name
+	btn.URL = url
+	btn.AppID = appID
+	btn.PagePath = pagePath
+
+	btn.Key = ""
+	btn.MediaID = ""
+	btn.SubButtons = nil
+}

menu/menu.go

@@ -4,8 +4,8 @@ import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/officialaccount/context"
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
@@ -18,42 +18,42 @@ const (
 	menuSelfMenuInfoURL      = "https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info"
 )
 
-// Menu struct
+//Menu struct
 type Menu struct {
 	*context.Context
 }
 
-// reqMenu 设置菜单请求数据
+//reqMenu 设置菜单请求数据
 type reqMenu struct {
 	Button    []*Button  `json:"button,omitempty"`
 	MatchRule *MatchRule `json:"matchrule,omitempty"`
 }
 
-// reqDeleteConditional 删除个性化菜单请求数据
+//reqDeleteConditional 删除个性化菜单请求数据
 type reqDeleteConditional struct {
 	MenuID int64 `json:"menuid"`
 }
 
-// reqMenuTryMatch 菜单匹配请求
+//reqMenuTryMatch 菜单匹配请求
 type reqMenuTryMatch struct {
 	UserID string `json:"user_id"`
 }
 
-// resConditionalMenu 个性化菜单返回结果
+//resConditionalMenu 个性化菜单返回结果
 type resConditionalMenu struct {
 	Button    []Button  `json:"button"`
 	MatchRule MatchRule `json:"matchrule"`
 	MenuID    int64     `json:"menuid"`
 }
 
-// resMenuTryMatch 菜单匹配请求结果
+//resMenuTryMatch 菜单匹配请求结果
 type resMenuTryMatch struct {
 	util.CommonError
 
 	Button []Button `json:"button"`
 }
 
-// ResMenu 查询菜单的返回数据
+//ResMenu 查询菜单的返回数据
 type ResMenu struct {
 	util.CommonError
 
@@ -64,7 +64,7 @@ type ResMenu struct {
 	Conditionalmenu []resConditionalMenu `json:"conditionalmenu"`
 }
 
-// ResSelfMenuInfo 自定义菜单配置返回结果
+//ResSelfMenuInfo 自定义菜单配置返回结果
 type ResSelfMenuInfo struct {
 	util.CommonError
 
@@ -74,7 +74,7 @@ type ResSelfMenuInfo struct {
 	} `json:"selfmenu_info"`
 }
 
-// SelfMenuButton 自定义菜单配置详情
+//SelfMenuButton 自定义菜单配置详情
 type SelfMenuButton struct {
 	Type      string `json:"type"`
 	Name      string `json:"name"`
@@ -89,7 +89,7 @@ type SelfMenuButton struct {
 	} `json:"news_info,omitempty"`
 }
 
-// ButtonNew 图文消息菜单
+//ButtonNew 图文消息菜单
 type ButtonNew struct {
 	Title      string `json:"title"`
 	Author     string `json:"author"`
@@ -100,25 +100,25 @@ type ButtonNew struct {
 	SourceURL  string `json:"source_url"`
 }
 
-// MatchRule 个性化菜单规则
+//MatchRule 个性化菜单规则
 type MatchRule struct {
-	GroupID            string `json:"group_id,omitempty"`
-	Sex                string `json:"sex,omitempty"`
+	GroupID            int32  `json:"group_id,omitempty"`
+	Sex                int32  `json:"sex,omitempty"`
 	Country            string `json:"country,omitempty"`
 	Province           string `json:"province,omitempty"`
 	City               string `json:"city,omitempty"`
-	ClientPlatformType string `json:"client_platform_type,omitempty"`
+	ClientPlatformType int32  `json:"client_platform_type,omitempty"`
 	Language           string `json:"language,omitempty"`
 }
 
-// NewMenu 实例
+//NewMenu 实例
 func NewMenu(context *context.Context) *Menu {
 	menu := new(Menu)
 	menu.Context = context
 	return menu
 }
 
-// SetMenu 设置按钮
+//SetMenu 设置按钮
 func (menu *Menu) SetMenu(buttons []*Button) error {
 	accessToken, err := menu.GetAccessToken()
 	if err != nil {
@@ -138,24 +138,7 @@ func (menu *Menu) SetMenu(buttons []*Button) error {
 	return util.DecodeWithCommonError(response, "SetMenu")
 }
 
-// SetMenuByJSON 设置按钮
-func (menu *Menu) SetMenuByJSON(jsonInfo string) error {
-	accessToken, err := menu.GetAccessToken()
-	if err != nil {
-		return err
-	}
-
-	uri := fmt.Sprintf("%s?access_token=%s", menuCreateURL, accessToken)
-
-	response, err := util.HTTPPost(uri, jsonInfo)
-	if err != nil {
-		return err
-	}
-
-	return util.DecodeWithCommonError(response, "SetMenuByJSON")
-}
-
-// GetMenu 获取菜单配置
+//GetMenu 获取菜单配置
 func (menu *Menu) GetMenu() (resMenu ResMenu, err error) {
 	var accessToken string
 	accessToken, err = menu.GetAccessToken()
@@ -179,7 +162,7 @@ func (menu *Menu) GetMenu() (resMenu ResMenu, err error) {
 	return
 }
 
-// DeleteMenu 删除菜单
+//DeleteMenu 删除菜单
 func (menu *Menu) DeleteMenu() error {
 	accessToken, err := menu.GetAccessToken()
 	if err != nil {
@@ -194,7 +177,7 @@ func (menu *Menu) DeleteMenu() error {
 	return util.DecodeWithCommonError(response, "GetMenu")
 }
 
-// AddConditional 添加个性化菜单
+//AddConditional 添加个性化菜单
 func (menu *Menu) AddConditional(buttons []*Button, matchRule *MatchRule) error {
 	accessToken, err := menu.GetAccessToken()
 	if err != nil {
@@ -215,23 +198,7 @@ func (menu *Menu) AddConditional(buttons []*Button, matchRule *MatchRule) error
 	return util.DecodeWithCommonError(response, "AddConditional")
 }
 
-// AddConditionalByJSON 添加个性化菜单
-func (menu *Menu) AddConditionalByJSON(jsonInfo string) error {
-	accessToken, err := menu.GetAccessToken()
-	if err != nil {
-		return err
-	}
-
-	uri := fmt.Sprintf("%s?access_token=%s", menuAddConditionalURL, accessToken)
-	response, err := util.HTTPPost(uri, jsonInfo)
-	if err != nil {
-		return err
-	}
-
-	return util.DecodeWithCommonError(response, "AddConditional")
-}
-
-// DeleteConditional 删除个性化菜单
+//DeleteConditional 删除个性化菜单
 func (menu *Menu) DeleteConditional(menuID int64) error {
 	accessToken, err := menu.GetAccessToken()
 	if err != nil {
@@ -251,7 +218,7 @@ func (menu *Menu) DeleteConditional(menuID int64) error {
 	return util.DecodeWithCommonError(response, "DeleteConditional")
 }
 
-// MenuTryMatch 菜单匹配
+//MenuTryMatch 菜单匹配
 func (menu *Menu) MenuTryMatch(userID string) (buttons []Button, err error) {
 	var accessToken string
 	accessToken, err = menu.GetAccessToken()
@@ -278,7 +245,7 @@ func (menu *Menu) MenuTryMatch(userID string) (buttons []Button, err error) {
 	return
 }
 
-// GetCurrentSelfMenuInfo 获取自定义菜单配置接口
+//GetCurrentSelfMenuInfo 获取自定义菜单配置接口
 func (menu *Menu) GetCurrentSelfMenuInfo() (resSelfMenuInfo ResSelfMenuInfo, err error) {
 	var accessToken string
 	accessToken, err = menu.GetAccessToken()

message/customer_message.go

@@ -3,45 +3,43 @@ package message
 import (
 	"encoding/json"
 	"fmt"
-
-	"github.com/silenceper/wechat/v2/officialaccount/context"
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
 	customerSendMessage = "https://api.weixin.qq.com/cgi-bin/message/custom/send"
 )
 
-// Manager 消息管理者，可以发送消息
+//Manager 消息管理者，可以发送消息
 type Manager struct {
 	*context.Context
 }
 
-// NewMessageManager 实例化消息管理者
+//NewMessageManager 实例化消息管理者
 func NewMessageManager(context *context.Context) *Manager {
 	return &Manager{
 		context,
 	}
 }
 
-// CustomerMessage  客服消息
+//CustomerMessage  客服消息
 type CustomerMessage struct {
-	ToUser          string                `json:"touser"`                    // 接受者OpenID
-	Msgtype         MsgType               `json:"msgtype"`                   // 客服消息类型
-	Text            *MediaText            `json:"text,omitempty"`            // 可选
-	Image           *MediaResource        `json:"image,omitempty"`           // 可选
-	Voice           *MediaResource        `json:"voice,omitempty"`           // 可选
-	Video           *MediaVideo           `json:"video,omitempty"`           // 可选
-	Music           *MediaMusic           `json:"music,omitempty"`           // 可选
-	News            *MediaNews            `json:"news,omitempty"`            // 可选
-	Mpnews          *MediaResource        `json:"mpnews,omitempty"`          // 可选
-	Wxcard          *MediaWxcard          `json:"wxcard,omitempty"`          // 可选
-	Msgmenu         *MediaMsgmenu         `json:"msgmenu,omitempty"`         // 可选
-	Miniprogrampage *MediaMiniprogrampage `json:"miniprogrampage,omitempty"` // 可选
-	Mpnewsarticle   *MediaArticle         `json:"mpnewsarticle,omitempty"`   // 可选
+	ToUser          string                `json:"touser"`                    //接受者OpenID
+	Msgtype         MsgType               `json:"msgtype"`                   //客服消息类型
+	Text            *MediaText            `json:"text,omitempty"`            //可选
+	Image           *MediaResource        `json:"image,omitempty"`           //可选
+	Voice           *MediaResource        `json:"voice,omitempty"`           //可选
+	Video           *MediaVideo           `json:"video,omitempty"`           //可选
+	Music           *MediaMusic           `json:"music,omitempty"`           //可选
+	News            *MediaNews            `json:"news,omitempty"`            //可选
+	Mpnews          *MediaResource        `json:"mpnews,omitempty"`          //可选
+	Wxcard          *MediaWxcard          `json:"wxcard,omitempty"`          //可选
+	Msgmenu         *MediaMsgmenu         `json:"msgmenu,omitempty"`         //可选
+	Miniprogrampage *MediaMiniprogrampage `json:"miniprogrampage,omitempty"` //可选
 }
 
-// NewCustomerTextMessage 文本消息结构体构造方法
+//NewCustomerTextMessage 文本消息结构体构造方法
 func NewCustomerTextMessage(toUser, text string) *CustomerMessage {
 	return &CustomerMessage{
 		ToUser:  toUser,
@@ -52,7 +50,7 @@ func NewCustomerTextMessage(toUser, text string) *CustomerMessage {
 	}
 }
 
-// NewCustomerImgMessage 图片消息的构造方法
+//NewCustomerImgMessage 图片消息的构造方法
 func NewCustomerImgMessage(toUser, mediaID string) *CustomerMessage {
 	return &CustomerMessage{
 		ToUser:  toUser,
@@ -63,7 +61,7 @@ func NewCustomerImgMessage(toUser, mediaID string) *CustomerMessage {
 	}
 }
 
-// NewCustomerVoiceMessage 语音消息的构造方法
+//NewCustomerVoiceMessage 语音消息的构造方法
 func NewCustomerVoiceMessage(toUser, mediaID string) *CustomerMessage {
 	return &CustomerMessage{
 		ToUser:  toUser,
@@ -74,36 +72,17 @@ func NewCustomerVoiceMessage(toUser, mediaID string) *CustomerMessage {
 	}
 }
 
-// NewCustomerMiniprogrampageMessage 小程序卡片消息的构造方法
-func NewCustomerMiniprogrampageMessage(toUser, title, appID, pagePath, thumbMediaID string) *CustomerMessage {
-	return &CustomerMessage{
-		ToUser:  toUser,
-		Msgtype: MsgTypeMiniprogrampage,
-		Miniprogrampage: &MediaMiniprogrampage{
-			Title:        title,
-			AppID:        appID,
-			Pagepath:     pagePath,
-			ThumbMediaID: thumbMediaID,
-		},
-	}
-}
-
-// MediaText 文本消息的文字
+//MediaText 文本消息的文字
 type MediaText struct {
 	Content string `json:"content"`
 }
 
-// MediaResource  消息使用的永久素材id
+//MediaResource  消息使用的永久素材id
 type MediaResource struct {
 	MediaID string `json:"media_id"`
 }
 
-// MediaArticle  消息使用的已发布文章id
-type MediaArticle struct {
-	ArticleID string `json:"article_id"`
-}
-
-// MediaVideo 视频消息包含的内容
+//MediaVideo 视频消息包含的内容
 type MediaVideo struct {
 	MediaID      string `json:"media_id"`
 	ThumbMediaID string `json:"thumb_media_id"`
@@ -111,7 +90,7 @@ type MediaVideo struct {
 	Description  string `json:"description"`
 }
 
-// MediaMusic 音乐消息包括的内容
+//MediaMusic 音乐消息包括的内容
 type MediaMusic struct {
 	Title        string `json:"title"`
 	Description  string `json:"description"`
@@ -120,12 +99,12 @@ type MediaMusic struct {
 	ThumbMediaID string `json:"thumb_media_id"`
 }
 
-// MediaNews 图文消息的内容
+//MediaNews 图文消息的内容
 type MediaNews struct {
 	Articles []MediaArticles `json:"articles"`
 }
 
-// MediaArticles 图文消息的内容的文章列表中的单独一条
+//MediaArticles 图文消息的内容的文章列表中的单独一条
 type MediaArticles struct {
 	Title       string `json:"title"`
 	Description string `json:"description"`
@@ -133,33 +112,33 @@ type MediaArticles struct {
 	Picurl      string `json:"picurl"`
 }
 
-// MediaMsgmenu 菜单消息的内容
+//MediaMsgmenu 菜单消息的内容
 type MediaMsgmenu struct {
 	HeadContent string        `json:"head_content"`
 	List        []MsgmenuItem `json:"list"`
 	TailContent string        `json:"tail_content"`
 }
 
-// MsgmenuItem 菜单消息的菜单按钮
+//MsgmenuItem 菜单消息的菜单按钮
 type MsgmenuItem struct {
 	ID      string `json:"id"`
 	Content string `json:"content"`
 }
 
-// MediaWxcard 卡券的id
+//MediaWxcard 卡券的id
 type MediaWxcard struct {
 	CardID string `json:"card_id"`
 }
 
-// MediaMiniprogrampage 小程序消息
+//MediaMiniprogrampage 小程序消息
 type MediaMiniprogrampage struct {
 	Title        string `json:"title"`
-	AppID        string `json:"appid"`
+	Appid        string `json:"appid"`
 	Pagepath     string `json:"pagepath"`
 	ThumbMediaID string `json:"thumb_media_id"`
 }
 
-// Send 发送客服消息
+//Send 发送客服消息
 func (manager *Manager) Send(msg *CustomerMessage) error {
 	accessToken, err := manager.Context.GetAccessToken()
 	if err != nil {
@@ -167,9 +146,6 @@ func (manager *Manager) Send(msg *CustomerMessage) error {
 	}
 	uri := fmt.Sprintf("%s?access_token=%s", customerSendMessage, accessToken)
 	response, err := util.PostJSON(uri, msg)
-	if err != nil {
-		return err
-	}
 	var result util.CommonError
 	err = json.Unmarshal(response, &result)
 	if err != nil {

message/image.go

@@ -1,6 +1,6 @@
 package message
 
-// Image 图片消息
+//Image 图片消息
 type Image struct {
 	CommonToken
 
@@ -9,7 +9,7 @@ type Image struct {
 	} `xml:"Image"`
 }
 
-// NewImage 回复图片消息
+//NewImage 回复图片消息
 func NewImage(mediaID string) *Image {
 	image := new(Image)
 	image.Image.MediaID = mediaID

message/message.go

@@ -0,0 +1,222 @@
+package message
+
+import (
+	"encoding/xml"
+
+	"github.com/silenceper/wechat/device"
+)
+
+// MsgType 基本消息类型
+type MsgType string
+
+// EventType 事件类型
+type EventType string
+
+// InfoType 第三方平台授权事件类型
+type InfoType string
+
+const (
+	//MsgTypeText 表示文本消息
+	MsgTypeText MsgType = "text"
+	//MsgTypeImage 表示图片消息
+	MsgTypeImage = "image"
+	//MsgTypeVoice 表示语音消息
+	MsgTypeVoice = "voice"
+	//MsgTypeVideo 表示视频消息
+	MsgTypeVideo = "video"
+	//MsgTypeShortVideo 表示短视频消息[限接收]
+	MsgTypeShortVideo = "shortvideo"
+	//MsgTypeLocation 表示坐标消息[限接收]
+	MsgTypeLocation = "location"
+	//MsgTypeLink 表示链接消息[限接收]
+	MsgTypeLink = "link"
+	//MsgTypeMusic 表示音乐消息[限回复]
+	MsgTypeMusic = "music"
+	//MsgTypeNews 表示图文消息[限回复]
+	MsgTypeNews = "news"
+	//MsgTypeTransfer 表示消息消息转发到客服
+	MsgTypeTransfer = "transfer_customer_service"
+	//MsgTypeEvent 表示事件推送消息
+	MsgTypeEvent = "event"
+)
+
+const (
+	//EventSubscribe 订阅
+	EventSubscribe EventType = "subscribe"
+	//EventUnsubscribe 取消订阅
+	EventUnsubscribe = "unsubscribe"
+	//EventScan 用户已经关注公众号，则微信会将带场景值扫描事件推送给开发者
+	EventScan = "SCAN"
+	//EventLocation 上报地理位置事件
+	EventLocation = "LOCATION"
+	//EventClick 点击菜单拉取消息时的事件推送
+	EventClick = "CLICK"
+	//EventView 点击菜单跳转链接时的事件推送
+	EventView = "VIEW"
+	//EventScancodePush 扫码推事件的事件推送
+	EventScancodePush = "scancode_push"
+	//EventScancodeWaitmsg 扫码推事件且弹出“消息接收中”提示框的事件推送
+	EventScancodeWaitmsg = "scancode_waitmsg"
+	//EventPicSysphoto 弹出系统拍照发图的事件推送
+	EventPicSysphoto = "pic_sysphoto"
+	//EventPicPhotoOrAlbum 弹出拍照或者相册发图的事件推送
+	EventPicPhotoOrAlbum = "pic_photo_or_album"
+	//EventPicWeixin 弹出微信相册发图器的事件推送
+	EventPicWeixin = "pic_weixin"
+	//EventLocationSelect 弹出地理位置选择器的事件推送
+	EventLocationSelect = "location_select"
+	//EventTemplateSendJobFinish 发送模板消息推送通知
+	EventTemplateSendJobFinish = "TEMPLATESENDJOBFINISH"
+	//EventWxaMediaCheck 异步校验图片/音频是否含有违法违规内容推送事件
+	EventWxaMediaCheck = "wxa_media_check"
+)
+
+const (
+	// InfoTypeVerifyTicket 返回ticket
+	InfoTypeVerifyTicket InfoType = "component_verify_ticket"
+	// InfoTypeAuthorized 授权
+	InfoTypeAuthorized = "authorized"
+	// InfoTypeUnauthorized 取消授权
+	InfoTypeUnauthorized = "unauthorized"
+	// InfoTypeUpdateAuthorized 更新授权
+	InfoTypeUpdateAuthorized = "updateauthorized"
+)
+
+//MixMessage 存放所有微信发送过来的消息和事件
+type MixMessage struct {
+	CommonToken
+
+	//基本消息
+	MsgID        int64   `xml:"MsgId"`
+	Content      string  `xml:"Content"`
+	Recognition  string  `xml:"Recognition"`
+	PicURL       string  `xml:"PicUrl"`
+	MediaID      string  `xml:"MediaId"`
+	Format       string  `xml:"Format"`
+	ThumbMediaID string  `xml:"ThumbMediaId"`
+	LocationX    float64 `xml:"Location_X"`
+	LocationY    float64 `xml:"Location_Y"`
+	Scale        float64 `xml:"Scale"`
+	Label        string  `xml:"Label"`
+	Title        string  `xml:"Title"`
+	Description  string  `xml:"Description"`
+	URL          string  `xml:"Url"`
+
+	//事件相关
+	Event       EventType `xml:"Event"`
+	EventKey    string    `xml:"EventKey"`
+	Ticket      string    `xml:"Ticket"`
+	Latitude    string    `xml:"Latitude"`
+	Longitude   string    `xml:"Longitude"`
+	Precision   string    `xml:"Precision"`
+	MenuID      string    `xml:"MenuId"`
+	Status      string    `xml:"Status"`
+	SessionFrom string    `xml:"SessionFrom"`
+
+	ScanCodeInfo struct {
+		ScanType   string `xml:"ScanType"`
+		ScanResult string `xml:"ScanResult"`
+	} `xml:"ScanCodeInfo"`
+
+	SendPicsInfo struct {
+		Count   int32      `xml:"Count"`
+		PicList []EventPic `xml:"PicList>item"`
+	} `xml:"SendPicsInfo"`
+
+	SendLocationInfo struct {
+		LocationX float64 `xml:"Location_X"`
+		LocationY float64 `xml:"Location_Y"`
+		Scale     float64 `xml:"Scale"`
+		Label     string  `xml:"Label"`
+		Poiname   string  `xml:"Poiname"`
+	}
+
+	// 第三方平台相关
+	InfoType                     InfoType `xml:"InfoType"`
+	AppID                        string   `xml:"AppId"`
+	ComponentVerifyTicket        string   `xml:"ComponentVerifyTicket"`
+	AuthorizerAppid              string   `xml:"AuthorizerAppid"`
+	AuthorizationCode            string   `xml:"AuthorizationCode"`
+	AuthorizationCodeExpiredTime int64    `xml:"AuthorizationCodeExpiredTime"`
+	PreAuthCode                  string   `xml:"PreAuthCode"`
+
+	// 卡券相关
+	CardID              string `xml:"CardId"`
+	RefuseReason        string `xml:"RefuseReason"`
+	IsGiveByFriend      int32  `xml:"IsGiveByFriend"`
+	FriendUserName      string `xml:"FriendUserName"`
+	UserCardCode        string `xml:"UserCardCode"`
+	OldUserCardCode     string `xml:"OldUserCardCode"`
+	OuterStr            string `xml:"OuterStr"`
+	IsRestoreMemberCard int32  `xml:"IsRestoreMemberCard"`
+	UnionID             string `xml:"UnionId"`
+
+	// 内容审核相关
+	IsRisky       bool   `xml:"isrisky"`
+	ExtraInfoJSON string `xml:"extra_info_json"`
+	TraceID       string `xml:"trace_id"`
+	StatusCode    int    `xml:"status_code"`
+
+	//设备相关
+	device.MsgDevice
+}
+
+//EventPic 发图事件推送
+type EventPic struct {
+	PicMd5Sum string `xml:"PicMd5Sum"`
+}
+
+//EncryptedXMLMsg 安全模式下的消息体
+type EncryptedXMLMsg struct {
+	XMLName      struct{} `xml:"xml" json:"-"`
+	ToUserName   string   `xml:"ToUserName" json:"ToUserName"`
+	EncryptedMsg string   `xml:"Encrypt"    json:"Encrypt"`
+}
+
+//ResponseEncryptedXMLMsg 需要返回的消息体
+type ResponseEncryptedXMLMsg struct {
+	XMLName      struct{} `xml:"xml" json:"-"`
+	EncryptedMsg string   `xml:"Encrypt"      json:"Encrypt"`
+	MsgSignature string   `xml:"MsgSignature" json:"MsgSignature"`
+	Timestamp    int64    `xml:"TimeStamp"    json:"TimeStamp"`
+	Nonce        string   `xml:"Nonce"        json:"Nonce"`
+}
+
+// CDATA  使用该类型,在序列化为 xml 文本时文本会被解析器忽略
+type CDATA string
+
+// MarshalXML 实现自己的序列化方法
+func (c CDATA) MarshalXML(e *xml.Encoder, start xml.StartElement) error {
+	return e.EncodeElement(struct {
+		string `xml:",cdata"`
+	}{string(c)}, start)
+}
+
+// CommonToken 消息中通用的结构
+type CommonToken struct {
+	XMLName      xml.Name `xml:"xml"`
+	ToUserName   CDATA    `xml:"ToUserName"`
+	FromUserName CDATA    `xml:"FromUserName"`
+	CreateTime   int64    `xml:"CreateTime"`
+	MsgType      MsgType  `xml:"MsgType"`
+}
+
+//SetToUserName set ToUserName
+func (msg *CommonToken) SetToUserName(toUserName CDATA) {
+	msg.ToUserName = toUserName
+}
+
+//SetFromUserName set FromUserName
+func (msg *CommonToken) SetFromUserName(fromUserName CDATA) {
+	msg.FromUserName = fromUserName
+}
+
+//SetCreateTime set createTime
+func (msg *CommonToken) SetCreateTime(createTime int64) {
+	msg.CreateTime = createTime
+}
+
+//SetMsgType set MsgType
+func (msg *CommonToken) SetMsgType(msgType MsgType) {
+	msg.MsgType = msgType
+}

message/music.go

@@ -1,6 +1,6 @@
 package message
 
-// Music 音乐消息
+//Music 音乐消息
 type Music struct {
 	CommonToken
 
@@ -13,7 +13,7 @@ type Music struct {
 	} `xml:"Music"`
 }
 
-// NewMusic  回复音乐消息
+//NewMusic  回复音乐消息
 func NewMusic(title, description, musicURL, hQMusicURL, thumbMediaID string) *Music {
 	music := new(Music)
 	music.Music.Title = title

message/news.go

@@ -1,6 +1,6 @@
 package message
 
-// News 图文消息
+//News 图文消息
 type News struct {
 	CommonToken
 
@@ -8,7 +8,7 @@ type News struct {
 	Articles     []*Article `xml:"Articles>item,omitempty"`
 }
 
-// NewNews 初始化图文消息
+//NewNews 初始化图文消息
 func NewNews(articles []*Article) *News {
 	news := new(News)
 	news.ArticleCount = len(articles)
@@ -16,7 +16,7 @@ func NewNews(articles []*Article) *News {
 	return news
 }
 
-// Article 单篇文章
+//Article 单篇文章
 type Article struct {
 	Title       string `xml:"Title,omitempty"`
 	Description string `xml:"Description,omitempty"`
@@ -24,7 +24,7 @@ type Article struct {
 	URL         string `xml:"Url,omitempty"`
 }
 
-// NewArticle 初始化文章
+//NewArticle 初始化文章
 func NewArticle(title, description, picURL, url string) *Article {
 	article := new(Article)
 	article.Title = title

message/ransfer_customer.go

@@ -1,23 +1,23 @@
 package message
 
-// TransferCustomer 转发客服消息
+//TransferCustomer 转发客服消息
 type TransferCustomer struct {
 	CommonToken
 
 	TransInfo *TransInfo `xml:"TransInfo,omitempty"`
 }
 
-// TransInfo 转发到指定客服
+//TransInfo 转发到指定客服
 type TransInfo struct {
 	KfAccount string `xml:"KfAccount"`
 }
 
-// NewTransferCustomer 实例化
-func NewTransferCustomer(kfAccount string) *TransferCustomer {
+//NewTransferCustomer 实例化
+func NewTransferCustomer(KfAccount string) *TransferCustomer {
 	tc := new(TransferCustomer)
-	if kfAccount != "" {
+	if KfAccount != "" {
 		transInfo := new(TransInfo)
-		transInfo.KfAccount = kfAccount
+		transInfo.KfAccount = KfAccount
 		tc.TransInfo = transInfo
 	}
 	return tc

message/reply.go

@@ -2,13 +2,13 @@ package message
 
 import "errors"
 
-// ErrInvalidReply 无效的回复
+//ErrInvalidReply 无效的回复
 var ErrInvalidReply = errors.New("无效的回复消息")
 
-// ErrUnsupportReply 不支持的回复类型
+//ErrUnsupportReply 不支持的回复类型
 var ErrUnsupportReply = errors.New("不支持的回复消息")
 
-// Reply 消息回复
+//Reply 消息回复
 type Reply struct {
 	MsgType MsgType
 	MsgData interface{}

message/template.go

@@ -0,0 +1,74 @@
+package message
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/silenceper/wechat/context"
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	templateSendURL = "https://api.weixin.qq.com/cgi-bin/message/template/send"
+)
+
+//Template 模板消息
+type Template struct {
+	*context.Context
+}
+
+//NewTemplate 实例化
+func NewTemplate(context *context.Context) *Template {
+	tpl := new(Template)
+	tpl.Context = context
+	return tpl
+}
+
+//Message 发送的模板消息内容
+type Message struct {
+	ToUser     string               `json:"touser"`          // 必须, 接受者OpenID
+	TemplateID string               `json:"template_id"`     // 必须, 模版ID
+	URL        string               `json:"url,omitempty"`   // 可选, 用户点击后跳转的URL, 该URL必须处于开发者在公众平台网站中设置的域中
+	Color      string               `json:"color,omitempty"` // 可选, 整个消息的颜色, 可以不设置
+	Data       map[string]*DataItem `json:"data"`            // 必须, 模板数据
+
+	MiniProgram struct {
+		AppID    string `json:"appid"`    //所需跳转到的小程序appid（该小程序appid必须与发模板消息的公众号是绑定关联关系）
+		PagePath string `json:"pagepath"` //所需跳转到小程序的具体页面路径，支持带参数,（示例index?foo=bar）
+	} `json:"miniprogram"` //可选,跳转至小程序地址
+}
+
+//DataItem 模版内某个 .DATA 的值
+type DataItem struct {
+	Value string `json:"value"`
+	Color string `json:"color,omitempty"`
+}
+
+type resTemplateSend struct {
+	util.CommonError
+
+	MsgID int64 `json:"msgid"`
+}
+
+//Send 发送模板消息
+func (tpl *Template) Send(msg *Message) (msgID int64, err error) {
+	var accessToken string
+	accessToken, err = tpl.GetAccessToken()
+	if err != nil {
+		return
+	}
+	uri := fmt.Sprintf("%s?access_token=%s", templateSendURL, accessToken)
+	response, err := util.PostJSON(uri, msg)
+
+	var result resTemplateSend
+	err = json.Unmarshal(response, &result)
+	if err != nil {
+		return
+	}
+	if result.ErrCode != 0 {
+		err = fmt.Errorf("template msg send error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
+		return
+	}
+	msgID = result.MsgID
+	return
+}

message/text.go

@@ -1,12 +1,12 @@
 package message
 
-// Text 文本消息
+//Text 文本消息
 type Text struct {
 	CommonToken
 	Content CDATA `xml:"Content"`
 }
 
-// NewText 初始化文本消息
+//NewText 初始化文本消息
 func NewText(content string) *Text {
 	text := new(Text)
 	text.Content = CDATA(content)

message/video.go

@@ -1,6 +1,6 @@
 package message
 
-// Video 视频消息
+//Video 视频消息
 type Video struct {
 	CommonToken
 
@@ -11,7 +11,7 @@ type Video struct {
 	} `xml:"Video"`
 }
 
-// NewVideo 回复图片消息
+//NewVideo 回复图片消息
 func NewVideo(mediaID, title, description string) *Video {
 	video := new(Video)
 	video.Video.MediaID = mediaID

message/voice.go

@@ -1,6 +1,6 @@
 package message
 
-// Voice 语音消息
+//Voice 语音消息
 type Voice struct {
 	CommonToken
 
@@ -9,7 +9,7 @@ type Voice struct {
 	} `xml:"Voice"`
 }
 
-// NewVoice 回复语音消息
+//NewVoice 回复语音消息
 func NewVoice(mediaID string) *Voice {
 	voice := new(Voice)
 	voice.Voice.MediaID = mediaID

minigame/README.md

@@ -1,9 +0,0 @@
-# 微信小游戏
-
-[官方文档](https://developers.weixin.qq.com/minigame/dev/api-backend/)
-
-## 快速入门
-
-```go
-
-```

miniprogram/README.md

@@ -1,51 +0,0 @@
-# 微信小程序
-
-[官方文档](https://developers.weixin.qq.com/miniprogram/dev/framework/)
-
-## 包说明
-
-- analysis 数据分析相关 API
-
-## 快速入门
-
-```go
-wc := wechat.NewWechat()
-memory := cache.NewMemory()
-cfg := &miniConfig.Config{
-    AppID:     "xxx",
-    AppSecret: "xxx",
-    Cache: memory,
-}
-miniprogram := wc.GetMiniProgram(cfg)
-miniprogram.GetAnalysis().GetAnalysisDailyRetain()
-```
-
-### 小程序虚拟支付 
-#### `注意：需要传入 Appkey、OfferID 的值`
-相关文档：[小程序虚拟支付](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/virtual-payment.html)
-```go
-wc := wechat.NewWechat()
-miniprogram := wc.GetMiniProgram(&miniConfig.Config{
-    AppID:     "xxx",
-    AppSecret: "xxx",
-    AppKey:    "xxx",
-    OfferID:   "xxx",
-    Cache: cache.NewMemory(),
-})
-virtualPayment := miniprogram.GetVirtualPayment()
-virtualPayment.SetSessionKey("xxx")
-// 查询用户余额
-var (
-    res *virtualPayment.QueryUserBalanceResponse
-    err error
-)
-
-if res, err = virtualPayment.QueryUserBalance(context.TODO(), &virtualPayment.QueryUserBalanceRequest{
-    OpenID: "xxx",
-    Env: virtualPayment.EnvProduction,
-    UserIP: "xxx",
-}); err != nil {
-    panic(err)
-}
-
-```

miniprogram/analysis.go

@@ -1,12 +1,10 @@
-package analysis
+package miniprogram
 
 import (
 	"encoding/json"
 	"fmt"
 
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
@@ -32,20 +30,10 @@ const (
 	getAnalysisVisitPageURL = "https://api.weixin.qq.com/datacube/getweanalysisappidvisitpage?access_token=%s"
 )
 
-// Analysis analyis 数据分析
-type Analysis struct {
-	*context.Context
-}
-
-// NewAnalysis new
-func NewAnalysis(ctx *context.Context) *Analysis {
-	return &Analysis{ctx}
-}
-
 // fetchData 拉取统计数据
-func (analysis *Analysis) fetchData(urlStr string, body interface{}) (response []byte, err error) {
+func (wxa *MiniProgram) fetchData(urlStr string, body interface{}) (response []byte, err error) {
 	var accessToken string
-	accessToken, err = analysis.GetAccessToken()
+	accessToken, err = wxa.GetAccessToken()
 	if err != nil {
 		return
 	}
@@ -54,8 +42,8 @@ func (analysis *Analysis) fetchData(urlStr string, body interface{}) (response [
 	return
 }
 
-// RetainItem 留存项结构
-type RetainItem struct {
+// AnalysisRetainItem 留存项结构
+type AnalysisRetainItem struct {
 	Key   int `json:"key"`   // 标识，0开始表示当天，1表示1甜后，以此类推
 	Value int `json:"value"` // key对应日期的新增用户数/活跃用户数（key=0时）或留存用户数（k>0时）
 }
@@ -63,18 +51,18 @@ type RetainItem struct {
 // ResAnalysisRetain 小程序留存数据返回
 type ResAnalysisRetain struct {
 	util.CommonError
-	RefDate    string       `json:"ref_date"`     // 日期
-	VisitUVNew []RetainItem `json:"visit_uv_new"` // 新增用户留存
-	VisitUV    []RetainItem `json:"visit_uv"`     // 活跃用户留存
+	RefDate    string               `json:"ref_date"`     // 日期
+	VisitUVNew []AnalysisRetainItem `json:"visit_uv_new"` // 新增用户留存
+	VisitUV    []AnalysisRetainItem `json:"visit_uv"`     // 活跃用户留存
 }
 
 // getAnalysisRetain 获取用户访问小程序留存数据(日、月、周)
-func (analysis *Analysis) getAnalysisRetain(urlStr string, beginDate, endDate string) (result ResAnalysisRetain, err error) {
+func (wxa *MiniProgram) getAnalysisRetain(urlStr string, beginDate, endDate string) (result ResAnalysisRetain, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(urlStr, body)
+	response, err := wxa.fetchData(urlStr, body)
 	if err != nil {
 		return
 	}
@@ -90,18 +78,18 @@ func (analysis *Analysis) getAnalysisRetain(urlStr string, beginDate, endDate st
 }
 
 // GetAnalysisDailyRetain 获取用户访问小程序日留存
-func (analysis *Analysis) GetAnalysisDailyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
-	return analysis.getAnalysisRetain(getAnalysisDailyRetainURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisDailyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
+	return wxa.getAnalysisRetain(getAnalysisDailyRetainURL, beginDate, endDate)
 }
 
 // GetAnalysisMonthlyRetain 获取用户访问小程序月留存
-func (analysis *Analysis) GetAnalysisMonthlyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
-	return analysis.getAnalysisRetain(getAnalysisMonthlyRetainURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisMonthlyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
+	return wxa.getAnalysisRetain(getAnalysisMonthlyRetainURL, beginDate, endDate)
 }
 
 // GetAnalysisWeeklyRetain 获取用户访问小程序周留存
-func (analysis *Analysis) GetAnalysisWeeklyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
-	return analysis.getAnalysisRetain(getAnalysisWeeklyRetainURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisWeeklyRetain(beginDate, endDate string) (result ResAnalysisRetain, err error) {
+	return wxa.getAnalysisRetain(getAnalysisWeeklyRetainURL, beginDate, endDate)
 }
 
 // ResAnalysisDailySummary 小程序访问数据概况
@@ -116,16 +104,16 @@ type ResAnalysisDailySummary struct {
 }
 
 // GetAnalysisDailySummary 获取用户访问小程序数据概况
-func (analysis *Analysis) GetAnalysisDailySummary(beginDate, endDate string) (result ResAnalysisDailySummary, err error) {
+func (wxa *MiniProgram) GetAnalysisDailySummary(beginDate, endDate string) (result ResAnalysisDailySummary, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(getAnalysisDailySummaryURL, body)
+	response, err := wxa.fetchData(getAnalysisDailySummaryURL, body)
 	if err != nil {
 		return
 	}
-
+	fmt.Println(string(response))
 	err = json.Unmarshal(response, &result)
 	if err != nil {
 		return
@@ -153,12 +141,12 @@ type ResAnalysisVisitTrend struct {
 }
 
 // getAnalysisRetain 获取小程序访问数据趋势(日、月、周)
-func (analysis *Analysis) getAnalysisVisitTrend(urlStr string, beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
+func (wxa *MiniProgram) getAnalysisVisitTrend(urlStr string, beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(urlStr, body)
+	response, err := wxa.fetchData(urlStr, body)
 	if err != nil {
 		return
 	}
@@ -174,25 +162,25 @@ func (analysis *Analysis) getAnalysisVisitTrend(urlStr string, beginDate, endDat
 }
 
 // GetAnalysisDailyVisitTrend 获取用户访问小程序数据日趋势
-func (analysis *Analysis) GetAnalysisDailyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
-	return analysis.getAnalysisVisitTrend(getAnalysisDailyVisitTrendURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisDailyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
+	return wxa.getAnalysisVisitTrend(getAnalysisDailyVisitTrendURL, beginDate, endDate)
 }
 
 // GetAnalysisMonthlyVisitTrend 获取用户访问小程序数据月趋势
-func (analysis *Analysis) GetAnalysisMonthlyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
-	return analysis.getAnalysisVisitTrend(getAnalysisMonthlyVisitTrendURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisMonthlyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
+	return wxa.getAnalysisVisitTrend(getAnalysisMonthlyVisitTrendURL, beginDate, endDate)
 }
 
 // GetAnalysisWeeklyVisitTrend 获取用户访问小程序数据周趋势
-func (analysis *Analysis) GetAnalysisWeeklyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
-	return analysis.getAnalysisVisitTrend(getAnalysisWeeklyVisitTrendURL, beginDate, endDate)
+func (wxa *MiniProgram) GetAnalysisWeeklyVisitTrend(beginDate, endDate string) (result ResAnalysisVisitTrend, err error) {
+	return wxa.getAnalysisVisitTrend(getAnalysisWeeklyVisitTrendURL, beginDate, endDate)
 }
 
 // UserPortraitItem 用户画像项目
 type UserPortraitItem struct {
-	ID    int    `json:"id"`    // 属性值id
-	Name  string `json:"name"`  // 属性值名称
-	Value int    `json:"value"` // 该场景访问uv
+	ID                  int    `json:"id"`                     // 属性值id
+	Name                string `json:"name"`                   // 属性值名称
+	AccessSourceVisitUV int    `json:"access_source_visit_uv"` // 该场景访问uv
 }
 
 // UserPortrait 用户画像
@@ -215,12 +203,12 @@ type ResAnalysisUserPortrait struct {
 }
 
 // GetAnalysisUserPortrait 获取小程序新增或活跃用户的画像分布数据
-func (analysis *Analysis) GetAnalysisUserPortrait(beginDate, endDate string) (result ResAnalysisUserPortrait, err error) {
+func (wxa *MiniProgram) GetAnalysisUserPortrait(beginDate, endDate string) (result ResAnalysisUserPortrait, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(getAnalysisUserPortraitURL, body)
+	response, err := wxa.fetchData(getAnalysisUserPortraitURL, body)
 	if err != nil {
 		return
 	}
@@ -256,12 +244,12 @@ type ResAnalysisVisitDistribution struct {
 }
 
 // GetAnalysisVisitDistribution 获取用户小程序访问分布数据
-func (analysis *Analysis) GetAnalysisVisitDistribution(beginDate, endDate string) (result ResAnalysisVisitDistribution, err error) {
+func (wxa *MiniProgram) GetAnalysisVisitDistribution(beginDate, endDate string) (result ResAnalysisVisitDistribution, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(getAnalysisVisitDistributionURL, body)
+	response, err := wxa.fetchData(getAnalysisVisitDistributionURL, body)
 	if err != nil {
 		return
 	}
@@ -296,12 +284,12 @@ type ResAnalysisVisitPage struct {
 }
 
 // GetAnalysisVisitPage 获取小程序页面访问数据
-func (analysis *Analysis) GetAnalysisVisitPage(beginDate, endDate string) (result ResAnalysisVisitPage, err error) {
+func (wxa *MiniProgram) GetAnalysisVisitPage(beginDate, endDate string) (result ResAnalysisVisitPage, err error) {
 	body := map[string]string{
 		"begin_date": beginDate,
 		"end_date":   endDate,
 	}
-	response, err := analysis.fetchData(getAnalysisVisitPageURL, body)
+	response, err := wxa.fetchData(getAnalysisVisitPageURL, body)
 	if err != nil {
 		return
 	}

miniprogram/auth/auth.go

@@ -1,148 +0,0 @@
-package auth
-
-import (
-	context2 "context"
-	"encoding/json"
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	code2SessionURL = "https://api.weixin.qq.com/sns/jscode2session?appid=%s&secret=%s&js_code=%s&grant_type=authorization_code"
-
-	checkEncryptedDataURL = "https://api.weixin.qq.com/wxa/business/checkencryptedmsg?access_token=%s"
-
-	getPhoneNumber = "https://api.weixin.qq.com/wxa/business/getuserphonenumber?access_token=%s"
-)
-
-// Auth 登录/用户信息
-type Auth struct {
-	*context.Context
-}
-
-// NewAuth new auth
-func NewAuth(ctx *context.Context) *Auth {
-	return &Auth{ctx}
-}
-
-// ResCode2Session 登录凭证校验的返回结果
-type ResCode2Session struct {
-	util.CommonError
-
-	OpenID     string `json:"openid"`      // 用户唯一标识
-	SessionKey string `json:"session_key"` // 会话密钥
-	UnionID    string `json:"unionid"`     // 用户在开放平台的唯一标识符，在满足UnionID下发条件的情况下会返回
-}
-
-// RspCheckEncryptedData .
-type RspCheckEncryptedData struct {
-	util.CommonError
-
-	Vaild      bool   `json:"vaild"`       // 是否是合法的数据
-	CreateTime uint64 `json:"create_time"` // 加密数据生成的时间戳
-}
-
-// Code2Session 登录凭证校验。
-func (auth *Auth) Code2Session(jsCode string) (result ResCode2Session, err error) {
-	return auth.Code2SessionContext(context2.Background(), jsCode)
-}
-
-// Code2SessionContext 登录凭证校验。
-func (auth *Auth) Code2SessionContext(ctx context2.Context, jsCode string) (result ResCode2Session, err error) {
-	var response []byte
-	if response, err = util.HTTPGetContext(ctx, fmt.Sprintf(code2SessionURL, auth.AppID, auth.AppSecret, jsCode)); err != nil {
-		return
-	}
-	if err = json.Unmarshal(response, &result); err != nil {
-		return
-	}
-	if result.ErrCode != 0 {
-		err = fmt.Errorf("Code2Session error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
-		return
-	}
-	return
-}
-
-// GetPaidUnionID 用户支付完成后，获取该用户的 UnionId，无需用户授权
-func (auth *Auth) GetPaidUnionID() {
-	// TODO
-}
-
-// CheckEncryptedData .检查加密信息是否由微信生成（当前只支持手机号加密数据），只能检测最近3天生成的加密数据
-func (auth *Auth) CheckEncryptedData(encryptedMsgHash string) (result RspCheckEncryptedData, err error) {
-	return auth.CheckEncryptedDataContext(context2.Background(), encryptedMsgHash)
-}
-
-// CheckEncryptedDataContext .检查加密信息是否由微信生成（当前只支持手机号加密数据），只能检测最近3天生成的加密数据
-func (auth *Auth) CheckEncryptedDataContext(ctx context2.Context, encryptedMsgHash string) (result RspCheckEncryptedData, err error) {
-	var response []byte
-	var (
-		at string
-	)
-	if at, err = auth.GetAccessToken(); err != nil {
-		return
-	}
-
-	// 由于GetPhoneNumberContext需要传入JSON，所以HTTPPostContext入参改为[]byte
-	if response, err = util.HTTPPostContext(ctx, fmt.Sprintf(checkEncryptedDataURL, at), []byte("encrypted_msg_hash="+encryptedMsgHash), nil); err != nil {
-		return
-	}
-	if err = util.DecodeWithError(response, &result, "CheckEncryptedDataAuth"); err != nil {
-		return
-	}
-	return
-}
-
-// GetPhoneNumberResponse 新版获取用户手机号响应结构体
-type GetPhoneNumberResponse struct {
-	util.CommonError
-
-	PhoneInfo PhoneInfo `json:"phone_info"`
-}
-
-// PhoneInfo 获取用户手机号内容
-type PhoneInfo struct {
-	PhoneNumber     string `json:"phoneNumber"`     // 用户绑定的手机号
-	PurePhoneNumber string `json:"purePhoneNumber"` // 没有区号的手机号
-	CountryCode     string `json:"countryCode"`     // 区号
-	WaterMark       struct {
-		Timestamp int64  `json:"timestamp"`
-		AppID     string `json:"appid"`
-	} `json:"watermark"` // 数据水印
-}
-
-// GetPhoneNumberContext 小程序通过code获取用户手机号
-func (auth *Auth) GetPhoneNumberContext(ctx context2.Context, code string) (*GetPhoneNumberResponse, error) {
-	var response []byte
-	var (
-		at  string
-		err error
-	)
-	if at, err = auth.GetAccessToken(); err != nil {
-		return nil, err
-	}
-	body := map[string]interface{}{
-		"code": code,
-	}
-
-	bodyBytes, err := json.Marshal(body)
-	if err != nil {
-		return nil, err
-	}
-
-	header := map[string]string{"Content-Type": "application/json;charset=utf-8"}
-	if response, err = util.HTTPPostContext(ctx, fmt.Sprintf(getPhoneNumber, at), bodyBytes, header); err != nil {
-		return nil, err
-	}
-
-	var result GetPhoneNumberResponse
-	err = util.DecodeWithError(response, &result, "phonenumber.getPhoneNumber")
-	return &result, err
-}
-
-// GetPhoneNumber 小程序通过code获取用户手机号
-func (auth *Auth) GetPhoneNumber(code string) (*GetPhoneNumberResponse, error) {
-	return auth.GetPhoneNumberContext(context2.Background(), code)
-}

miniprogram/business/business.go

@@ -1,13 +0,0 @@
-package business
-
-import "github.com/silenceper/wechat/v2/miniprogram/context"
-
-// Business 业务
-type Business struct {
-	*context.Context
-}
-
-// NewBusiness init
-func NewBusiness(ctx *context.Context) *Business {
-	return &Business{ctx}
-}

miniprogram/business/phone_number.go

@@ -1,49 +0,0 @@
-package business
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	getPhoneNumberURL = "https://api.weixin.qq.com/wxa/business/getuserphonenumber?access_token=%s"
-)
-
-// GetPhoneNumberRequest 获取手机号请求
-type GetPhoneNumberRequest struct {
-	Code string `json:"code"` // 手机号获取凭证
-}
-
-// PhoneInfo 手机号信息
-type PhoneInfo struct {
-	PhoneNumber     string `json:"phoneNumber"`     // 用户绑定的手机号（国外手机号会有区号）
-	PurePhoneNumber string `json:"purePhoneNumber"` // 没有区号的手机号
-	CountryCode     string `json:"countryCode"`     // 区号
-	Watermark       struct {
-		AppID     string `json:"appid"`     // 小程序appid
-		Timestamp int64  `json:"timestamp"` // 用户获取手机号操作的时间戳
-	} `json:"watermark"`
-}
-
-// GetPhoneNumber code换取用户手机号。 每个code只能使用一次，code的有效期为5min
-func (business *Business) GetPhoneNumber(in *GetPhoneNumberRequest) (info PhoneInfo, err error) {
-	accessToken, err := business.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(getPhoneNumberURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	var resp struct {
-		util.CommonError
-		PhoneInfo PhoneInfo `json:"phone_info"`
-	}
-	err = util.DecodeWithError(response, &resp, "business.GetPhoneNumber")
-	return resp.PhoneInfo, err
-}

miniprogram/config/config.go

@@ -1,17 +0,0 @@
-// Package config 小程序 config 配置
-package config
-
-import (
-	"github.com/silenceper/wechat/v2/cache"
-)
-
-// Config .config for 小程序
-type Config struct {
-	AppID          string `json:"app_id"`           // appid
-	AppSecret      string `json:"app_secret"`       // appSecret
-	AppKey         string `json:"app_key"`          // appKey
-	OfferID        string `json:"offer_id"`         // offerId
-	Token          string `json:"token"`            // token
-	EncodingAESKey string `json:"encoding_aes_key"` // EncodingAESKey
-	Cache          cache.Cache
-}

miniprogram/content/content.go

@@ -1,65 +0,0 @@
-package content
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	checkTextURL  = "https://api.weixin.qq.com/wxa/msg_sec_check?access_token=%s"
-	checkImageURL = "https://api.weixin.qq.com/wxa/img_sec_check?access_token=%s"
-)
-
-// Content 内容安全
-type Content struct {
-	*context.Context
-}
-
-// NewContent 内容安全接口
-func NewContent(ctx *context.Context) *Content {
-	return &Content{ctx}
-}
-
-// CheckText 检测文字
-// @text 需要检测的文字
-// Deprecated
-// 采用 security.MsgCheckV1 替代，返回值更加丰富
-func (content *Content) CheckText(text string) error {
-	accessToken, err := content.GetAccessToken()
-	if err != nil {
-		return err
-	}
-	response, err := util.PostJSON(
-		fmt.Sprintf(checkTextURL, accessToken),
-		map[string]string{
-			"content": text,
-		},
-	)
-	if err != nil {
-		return err
-	}
-	return util.DecodeWithCommonError(response, "ContentCheckText")
-}
-
-// CheckImage 检测图片
-// 所传参数为要检测的图片文件的绝对路径，图片格式支持PNG、JPEG、JPG、GIF, 像素不超过 750 x 1334，同时文件大小以不超过 300K 为宜，否则可能报错
-// @media 图片文件的绝对路径
-// Deprecated
-// 采用 security.ImageCheckV1 替代，返回值更加丰富
-func (content *Content) CheckImage(media string) error {
-	accessToken, err := content.GetAccessToken()
-	if err != nil {
-		return err
-	}
-	response, err := util.PostFile(
-		"media",
-		media,
-		fmt.Sprintf(checkImageURL, accessToken),
-	)
-	if err != nil {
-		return err
-	}
-	return util.DecodeWithCommonError(response, "ContentCheckImage")
-}

miniprogram/context/context.go

@@ -1,12 +0,0 @@
-package context
-
-import (
-	"github.com/silenceper/wechat/v2/credential"
-	"github.com/silenceper/wechat/v2/miniprogram/config"
-)
-
-// Context struct
-type Context struct {
-	*config.Config
-	credential.AccessTokenHandle
-}

miniprogram/decrypt.go

@@ -1,4 +1,4 @@
-package encryptor
+package miniprogram
 
 import (
 	"crypto/aes"
@@ -6,23 +6,8 @@ import (
 	"encoding/base64"
 	"encoding/json"
 	"errors"
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
 )
 
-// Encryptor struct
-type Encryptor struct {
-	*context.Context
-}
-
-// NewEncryptor 实例
-func NewEncryptor(context *context.Context) *Encryptor {
-	basic := new(Encryptor)
-	basic.Context = context
-	return basic
-}
-
 var (
 	// ErrAppIDNotMatch appid不匹配
 	ErrAppIDNotMatch = errors.New("app id not match")
@@ -34,20 +19,26 @@ var (
 	ErrInvalidPKCS7Padding = errors.New("invalid padding on input")
 )
 
-// PlainData 用户信息/手机号信息
-type PlainData struct {
-	OpenID          string `json:"openId"`
-	UnionID         string `json:"unionId"`
-	NickName        string `json:"nickName"`
-	Gender          int    `json:"gender"`
-	City            string `json:"city"`
-	Province        string `json:"province"`
-	Country         string `json:"country"`
-	AvatarURL       string `json:"avatarUrl"`
-	Language        string `json:"language"`
+// UserInfo 用户信息
+type UserInfo struct {
+	OpenID    string `json:"openId"`
+	UnionID   string `json:"unionId"`
+	NickName  string `json:"nickName"`
+	Gender    int    `json:"gender"`
+	City      string `json:"city"`
+	Province  string `json:"province"`
+	Country   string `json:"country"`
+	AvatarURL string `json:"avatarUrl"`
+	Language  string `json:"language"`
+	Watermark struct {
+		Timestamp int64  `json:"timestamp"`
+		AppID     string `json:"appid"`
+	} `json:"watermark"`
+}
+
+// PhoneInfo 用户手机号
+type PhoneInfo struct {
 	PhoneNumber     string `json:"phoneNumber"`
-	OpenGID         string `json:"openGId"`
-	MsgTicket       string `json:"msgTicket"`
 	PurePhoneNumber string `json:"purePhoneNumber"`
 	CountryCode     string `json:"countryCode"`
 	Watermark       struct {
@@ -77,8 +68,8 @@ func pkcs7Unpad(data []byte, blockSize int) ([]byte, error) {
 	return data[:len(data)-n], nil
 }
 
-// GetCipherText returns slice of the cipher text
-func GetCipherText(sessionKey, encryptedData, iv string) ([]byte, error) {
+// getCipherText returns slice of the cipher text
+func getCipherText(sessionKey, encryptedData, iv string) ([]byte, error) {
 	aesKey, err := base64.StdEncoding.DecodeString(sessionKey)
 	if err != nil {
 		return nil, err
@@ -91,9 +82,6 @@ func GetCipherText(sessionKey, encryptedData, iv string) ([]byte, error) {
 	if err != nil {
 		return nil, err
 	}
-	if len(ivBytes) != aes.BlockSize {
-		return nil, fmt.Errorf("bad iv length %d", len(ivBytes))
-	}
 	block, err := aes.NewCipher(aesKey)
 	if err != nil {
 		return nil, err
@@ -108,18 +96,35 @@ func GetCipherText(sessionKey, encryptedData, iv string) ([]byte, error) {
 }
 
 // Decrypt 解密数据
-func (encryptor *Encryptor) Decrypt(sessionKey, encryptedData, iv string) (*PlainData, error) {
-	cipherText, err := GetCipherText(sessionKey, encryptedData, iv)
+func (wxa *MiniProgram) Decrypt(sessionKey, encryptedData, iv string) (*UserInfo, error) {
+	cipherText, err := getCipherText(sessionKey, encryptedData, iv)
 	if err != nil {
 		return nil, err
 	}
-	var plainData PlainData
-	err = json.Unmarshal(cipherText, &plainData)
+	var userInfo UserInfo
+	err = json.Unmarshal(cipherText, &userInfo)
 	if err != nil {
 		return nil, err
 	}
-	if plainData.Watermark.AppID != encryptor.AppID {
+	if userInfo.Watermark.AppID != wxa.AppID {
 		return nil, ErrAppIDNotMatch
 	}
-	return &plainData, nil
+	return &userInfo, nil
+}
+
+// DecryptPhone 解密数据(手机)
+func (wxa *MiniProgram) DecryptPhone(sessionKey, encryptedData, iv string) (*PhoneInfo, error) {
+	cipherText, err := getCipherText(sessionKey, encryptedData, iv)
+	if err != nil {
+		return nil, err
+	}
+	var phoneInfo PhoneInfo
+	err = json.Unmarshal(cipherText, &phoneInfo)
+	if err != nil {
+		return nil, err
+	}
+	if phoneInfo.Watermark.AppID != wxa.AppID {
+		return nil, ErrAppIDNotMatch
+	}
+	return &phoneInfo, nil
 }

miniprogram/encryptor/encryptor_test.go

@@ -1,15 +0,0 @@
-package encryptor
-
-import (
-	"encoding/base64"
-	"testing"
-
-	"github.com/stretchr/testify/assert"
-)
-
-func TestGetCipherText_BadIV(t *testing.T) {
-	keyData := base64.StdEncoding.EncodeToString([]byte("1234567890123456"))
-	badData := base64.StdEncoding.EncodeToString([]byte("1"))
-	_, err := GetCipherText(keyData, badData, badData)
-	assert.Error(t, err)
-}

miniprogram/message/consts.go

@@ -1,63 +0,0 @@
-package message
-
-import "encoding/xml"
-
-// MsgType 基本消息类型
-type MsgType string
-
-// EventType 事件类型
-type EventType string
-
-// InfoType 第三方平台授权事件类型
-type InfoType string
-
-const (
-	// MsgTypeText 文本消息
-	MsgTypeText MsgType = "text"
-	// MsgTypeImage 图片消息
-	MsgTypeImage = "image"
-	// MsgTypeLink 图文链接
-	MsgTypeLink = "link"
-	// MsgTypeMiniProgramPage 小程序卡片
-	MsgTypeMiniProgramPage = "miniprogrampage"
-	// MsgTypeEvent 事件
-	MsgTypeEvent MsgType = "event"
-	// DataTypeXML XML 格式数据
-	DataTypeXML = "xml"
-	// DataTypeJSON JSON 格式数据
-	DataTypeJSON = "json"
-)
-
-// CommonToken 消息中通用的结构
-type CommonToken struct {
-	XMLName      xml.Name `xml:"xml"`
-	ToUserName   string   `xml:"ToUserName"`
-	FromUserName string   `xml:"FromUserName"`
-	CreateTime   int64    `xml:"CreateTime"`
-	MsgType      MsgType  `xml:"MsgType"`
-}
-
-// MiniProgramMixMessage 小程序回调的消息结构
-type MiniProgramMixMessage struct {
-	CommonToken
-
-	MsgID int64 `xml:"MsgId"`
-
-	// 文本消息
-	Content string `xml:"Content"`
-
-	// 图片消息
-	PicURL  string `xml:"PicUrl"`
-	MediaID string `xml:"MediaId"`
-
-	// 小程序卡片消息
-	Title        string `xml:"Title"`
-	AppID        string `xml:"AppId"`
-	PagePath     string `xml:"PagePath"`
-	ThumbURL     string `xml:"ThumbUrl"`
-	ThumbMediaID string `xml:"ThumbMediaId"`
-
-	// 进入会话事件
-	Event       string `xml:"Event"`
-	SessionFrom string `xml:"SessionFrom"`
-}

miniprogram/message/customer_message.go

@@ -1,124 +0,0 @@
-package message
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	customerSendMessage = "https://api.weixin.qq.com/cgi-bin/message/custom/send"
-)
-
-// Manager 消息管理者，可以发送消息
-type Manager struct {
-	*context.Context
-}
-
-// NewCustomerMessageManager 实例化消息管理者
-func NewCustomerMessageManager(context *context.Context) *Manager {
-	return &Manager{
-		context,
-	}
-}
-
-// MediaText 文本消息的文字
-type MediaText struct {
-	Content string `json:"content"`
-}
-
-// MediaResource  消息使用的临时素材 id
-type MediaResource struct {
-	MediaID string `json:"media_id"`
-}
-
-// MediaMiniprogrampage 小程序卡片
-type MediaMiniprogrampage struct {
-	Title        string `json:"title"`
-	Appid        string `json:"appid"`
-	Pagepath     string `json:"pagepath"`
-	ThumbMediaID string `json:"thumb_media_id"`
-}
-
-// MediaLink 发送图文链接
-type MediaLink struct {
-	Title       string `json:"title"`
-	Description string `json:"description"`
-	URL         string `json:"url"`
-	ThumbURL    string `json:"thumb_url"`
-}
-
-// CustomerMessage  客服消息
-type CustomerMessage struct {
-	ToUser          string                `json:"touser"`                    // 接受者 OpenID
-	Msgtype         MsgType               `json:"msgtype"`                   // 客服消息类型
-	Text            *MediaText            `json:"text,omitempty"`            // 可选
-	Image           *MediaResource        `json:"image,omitempty"`           // 可选
-	Link            *MediaLink            `json:"link,omitempty"`            // 可选
-	Miniprogrampage *MediaMiniprogrampage `json:"miniprogrampage,omitempty"` // 可选
-}
-
-// NewCustomerTextMessage 文本消息结构体构造方法
-func NewCustomerTextMessage(toUser, text string) *CustomerMessage {
-	return &CustomerMessage{
-		ToUser:  toUser,
-		Msgtype: MsgTypeText,
-		Text: &MediaText{
-			Content: text,
-		},
-	}
-}
-
-// NewCustomerImgMessage 图片消息的构造方法
-func NewCustomerImgMessage(toUser, mediaID string) *CustomerMessage {
-	return &CustomerMessage{
-		ToUser:  toUser,
-		Msgtype: MsgTypeImage,
-		Image: &MediaResource{
-			MediaID: mediaID,
-		},
-	}
-}
-
-// NewCustomerLinkMessage 图文链接消息的构造方法
-func NewCustomerLinkMessage(toUser, title, description, url, thumbURL string) *CustomerMessage {
-	return &CustomerMessage{
-		ToUser:  toUser,
-		Msgtype: MsgTypeLink,
-		Link: &MediaLink{
-			Title:       title,
-			Description: description,
-			URL:         url,
-			ThumbURL:    thumbURL,
-		},
-	}
-}
-
-// NewCustomerMiniprogrampageMessage 小程序卡片消息的构造方法
-func NewCustomerMiniprogrampageMessage(toUser, title, pagepath, thumbMediaID string) *CustomerMessage {
-	return &CustomerMessage{
-		ToUser:  toUser,
-		Msgtype: MsgTypeMiniProgramPage,
-		Miniprogrampage: &MediaMiniprogrampage{
-			Title:        title,
-			Pagepath:     pagepath,
-			ThumbMediaID: thumbMediaID,
-		},
-	}
-}
-
-// Send 发送客服消息
-func (manager *Manager) Send(msg *CustomerMessage) error {
-	accessToken, err := manager.Context.GetAccessToken()
-	if err != nil {
-		return err
-	}
-	uri := fmt.Sprintf("%s?access_token=%s", customerSendMessage, accessToken)
-	response, err := util.PostJSON(uri, msg)
-	if err != nil {
-		return err
-	}
-
-	return util.DecodeWithCommonError(response, "SendCustomerMessage")
-}

miniprogram/message/message.go

@@ -1,579 +0,0 @@
-package message
-
-import (
-	"encoding/json"
-	"encoding/xml"
-	"errors"
-	"io"
-	"net/http"
-	"sort"
-	"strings"
-
-	"github.com/tidwall/gjson"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/miniprogram/security"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-// ConfirmReceiveMethod 确认收货方式
-type ConfirmReceiveMethod int8
-
-const (
-	// EventTypeTradeManageRemindAccessAPI 提醒接入发货信息管理服务 API
-	// 小程序完成账期授权时/小程序产生第一笔交易时/已产生交易但从未发货的小程序，每天一次
-	EventTypeTradeManageRemindAccessAPI EventType = "trade_manage_remind_access_api"
-	// EventTypeTradeManageRemindShipping 提醒需要上传发货信息
-	// 曾经发过货的小程序，订单超过 48 小时未发货时
-	EventTypeTradeManageRemindShipping EventType = "trade_manage_remind_shipping"
-	// EventTypeTradeManageOrderSettlement 订单将要结算或已经结算
-	// 订单完成发货时/订单结算时
-	EventTypeTradeManageOrderSettlement EventType = "trade_manage_order_settlement"
-	// EventTypeAddExpressPath 运单轨迹更新事件
-	EventTypeAddExpressPath EventType = "add_express_path"
-	// EventTypeSecvodUpload 短剧媒资上传完成事件
-	EventTypeSecvodUpload EventType = "secvod_upload_event"
-	// EventTypeSecvodAudit 短剧媒资审核状态事件
-	EventTypeSecvodAudit EventType = "secvod_audit_event"
-	// EventTypeWxaMediaCheck 媒体内容安全异步审查结果通知
-	EventTypeWxaMediaCheck EventType = "wxa_media_check"
-	// EventTypeXpayGoodsDeliverNotify 道具发货推送事件
-	EventTypeXpayGoodsDeliverNotify EventType = "xpay_goods_deliver_notify"
-	// EventTypeXpayCoinPayNotify 代币支付推送事件
-	EventTypeXpayCoinPayNotify EventType = "xpay_coin_pay_notify"
-	// EventSubscribePopup 用户操作订阅通知弹窗事件推送，用户在图文等场景内订阅通知的操作
-	EventSubscribePopup EventType = "subscribe_msg_popup_event"
-	// EventSubscribeMsgChange 用户管理订阅通知，用户在服务通知管理页面做通知管理时的操作
-	EventSubscribeMsgChange EventType = "subscribe_msg_change_event"
-	// EventSubscribeMsgSent 发送订阅通知，调用 bizsend 接口发送通知
-	EventSubscribeMsgSent EventType = "subscribe_msg_sent_event"
-	// ConfirmReceiveMethodAuto 自动确认收货
-	ConfirmReceiveMethodAuto ConfirmReceiveMethod = 1
-	// ConfirmReceiveMethodManual 手动确认收货
-	ConfirmReceiveMethodManual ConfirmReceiveMethod = 2
-)
-
-const (
-	// InfoTypeAcceptSubscribeMessage 接受订阅通知
-	InfoTypeAcceptSubscribeMessage InfoType = "accept"
-	// InfoTypeRejectSubscribeMessage 拒绝订阅通知
-	InfoTypeRejectSubscribeMessage InfoType = "reject"
-)
-
-// PushReceiver 接收消息推送
-// 暂仅支付 Aes 加密方式
-type PushReceiver struct {
-	*context.Context
-}
-
-// NewPushReceiver 实例化
-func NewPushReceiver(ctx *context.Context) *PushReceiver {
-	return &PushReceiver{
-		Context: ctx,
-	}
-}
-
-// GetMsg 获取接收到的消息 (如果是加密的返回解密数据)
-func (receiver *PushReceiver) GetMsg(r *http.Request) (string, []byte, error) {
-	// 判断请求格式
-	var dataType string
-	contentType := r.Header.Get("Content-Type")
-	if strings.HasPrefix(contentType, "text/xml") {
-		// xml 格式
-		dataType = DataTypeXML
-	} else {
-		// json 格式
-		dataType = DataTypeJSON
-	}
-
-	// 读取参数，验证签名
-	signature := r.FormValue("signature")
-	timestamp := r.FormValue("timestamp")
-	nonce := r.FormValue("nonce")
-	encryptType := r.FormValue("encrypt_type")
-	// 验证签名
-	tmpArr := []string{
-		receiver.Token,
-		timestamp,
-		nonce,
-	}
-	sort.Strings(tmpArr)
-	tmpSignature := util.Signature(tmpArr...)
-	if tmpSignature != signature {
-		return dataType, nil, errors.New("signature error")
-	}
-
-	if encryptType == "aes" {
-		// 解密
-		var reqData DataReceived
-		if dataType == DataTypeXML {
-			if err := xml.NewDecoder(r.Body).Decode(&reqData); err != nil {
-				return dataType, nil, err
-			}
-		} else {
-			if err := json.NewDecoder(r.Body).Decode(&reqData); err != nil {
-				return dataType, nil, err
-			}
-		}
-		_, rawMsgBytes, err := util.DecryptMsg(receiver.AppID, reqData.Encrypt, receiver.EncodingAESKey)
-		return dataType, rawMsgBytes, err
-	}
-	// 不加密
-	byteData, err := io.ReadAll(r.Body)
-	return dataType, byteData, err
-}
-
-// GetMsgData 获取接收到的消息 (解密数据)
-func (receiver *PushReceiver) GetMsgData(r *http.Request) (MsgType, EventType, PushData, error) {
-	dataType, decryptMsg, err := receiver.GetMsg(r)
-	if err != nil {
-		return "", "", nil, err
-	}
-	var (
-		msgType   MsgType
-		eventType EventType
-	)
-	if dataType == DataTypeXML {
-		var commonToken CommonPushData
-		if err := xml.Unmarshal(decryptMsg, &commonToken); err != nil {
-			return "", "", nil, err
-		}
-		msgType, eventType = commonToken.MsgType, commonToken.Event
-	} else {
-		var commonToken CommonPushData
-		if err := json.Unmarshal(decryptMsg, &commonToken); err != nil {
-			return "", "", nil, err
-		}
-		msgType, eventType = commonToken.MsgType, commonToken.Event
-	}
-	if msgType == MsgTypeEvent {
-		pushData, err := receiver.getEvent(dataType, eventType, decryptMsg)
-		// 暂不支持其他事件类型
-		return msgType, eventType, pushData, err
-	}
-	// 暂不支持其他消息类型
-	return msgType, eventType, decryptMsg, nil
-}
-
-// getEvent 获取事件推送的数据
-func (receiver *PushReceiver) getEvent(dataType string, eventType EventType, decryptMsg []byte) (PushData, error) {
-	switch eventType {
-	case EventTypeTradeManageRemindAccessAPI:
-		// 提醒接入发货信息管理服务 API
-		var pushData PushDataRemindAccessAPI
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeTradeManageRemindShipping:
-		// 提醒需要上传发货信息
-		var pushData PushDataRemindShipping
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeTradeManageOrderSettlement:
-		// 订单将要结算或已经结算
-		var pushData PushDataOrderSettlement
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeWxaMediaCheck:
-		// 媒体内容安全异步审查结果通知
-		var pushData MediaCheckAsyncData
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeAddExpressPath:
-		// 运单轨迹更新
-		var pushData PushDataAddExpressPath
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeSecvodUpload:
-		// 短剧媒资上传完成
-		var pushData PushDataSecVodUpload
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeSecvodAudit:
-		// 短剧媒资审核状态
-		var pushData PushDataSecVodAudit
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeXpayGoodsDeliverNotify:
-		// 道具发货推送事件
-		var pushData PushDataXpayGoodsDeliverNotify
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventTypeXpayCoinPayNotify:
-		// 代币支付推送事件
-		var pushData PushDataXpayCoinPayNotify
-		err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-		return &pushData, err
-	case EventSubscribePopup:
-		// 用户操作订阅通知弹窗事件推送
-		return receiver.unmarshalSubscribePopup(dataType, decryptMsg)
-	case EventSubscribeMsgChange:
-		// 用户管理订阅通知事件推送
-		return receiver.unmarshalSubscribeMsgChange(dataType, decryptMsg)
-	case EventSubscribeMsgSent:
-		// 用户发送订阅通知事件推送
-		return receiver.unmarshalSubscribeMsgSent(dataType, decryptMsg)
-	}
-	// 暂不支持其他事件类型，直接返回解密后的数据，由调用方处理
-	return decryptMsg, nil
-}
-
-// unmarshal 解析推送的数据
-func (receiver *PushReceiver) unmarshal(dataType string, decryptMsg []byte, pushData interface{}) error {
-	if dataType == DataTypeXML {
-		return xml.Unmarshal(decryptMsg, pushData)
-	}
-	return json.Unmarshal(decryptMsg, pushData)
-}
-
-// unmarshalSubscribePopup
-func (receiver *PushReceiver) unmarshalSubscribePopup(dataType string, decryptMsg []byte) (PushData, error) {
-	var pushData PushDataSubscribePopup
-	err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-	if err == nil {
-		listData := gjson.Get(string(decryptMsg), "List")
-		if listData.IsObject() {
-			listItem := SubscribeMsgPopupEventList{}
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItem); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgPopupEvents([]SubscribeMsgPopupEventList{listItem})
-		} else if listData.IsArray() {
-			listItems := make([]SubscribeMsgPopupEventList, 0)
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItems); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgPopupEvents(listItems)
-		}
-	}
-
-	return &pushData, err
-}
-
-// unmarshalSubscribeMsgChange 解析用户管理订阅通知事件推送
-func (receiver *PushReceiver) unmarshalSubscribeMsgChange(dataType string, decryptMsg []byte) (PushData, error) {
-	var pushData PushDataSubscribeMsgChange
-	err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-	if err == nil {
-		listData := gjson.Get(string(decryptMsg), "List")
-		if listData.IsObject() {
-			listItem := SubscribeMsgChangeList{}
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItem); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgChangeEvents([]SubscribeMsgChangeList{listItem})
-		} else if listData.IsArray() {
-			listItems := make([]SubscribeMsgChangeList, 0)
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItems); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgChangeEvents(listItems)
-		}
-	}
-	return &pushData, err
-}
-
-// unmarshalSubscribeMsgSent 解析用户发送订阅通知事件推送
-func (receiver *PushReceiver) unmarshalSubscribeMsgSent(dataType string, decryptMsg []byte) (PushData, error) {
-	var pushData PushDataSubscribeMsgSent
-	err := receiver.unmarshal(dataType, decryptMsg, &pushData)
-	if err == nil {
-		listData := gjson.Get(string(decryptMsg), "List")
-		if listData.IsObject() {
-			listItem := SubscribeMsgSentList{}
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItem); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgSentEvents([]SubscribeMsgSentList{listItem})
-		} else if listData.IsArray() {
-			listItems := make([]SubscribeMsgSentList, 0)
-			if parseErr := json.Unmarshal([]byte(listData.Raw), &listItems); parseErr != nil {
-				return &pushData, parseErr
-			}
-			pushData.SetSubscribeMsgSentEvents(listItems)
-		}
-	}
-	return &pushData, err
-}
-
-// DataReceived 接收到的数据
-type DataReceived struct {
-	Encrypt string `json:"Encrypt" xml:"Encrypt"` // 加密的消息体
-}
-
-// PushData 推送的数据 (已转对应的结构体)
-type PushData interface{}
-
-// CommonPushData 推送数据通用部分
-type CommonPushData struct {
-	XMLName      xml.Name  `json:"-" xml:"xml"`
-	MsgType      MsgType   `json:"MsgType" xml:"MsgType"`           // 消息类型，为固定值 "event"
-	Event        EventType `json:"Event" xml:"Event"`               // 事件类型
-	ToUserName   string    `json:"ToUserName" xml:"ToUserName"`     // 小程序的原始 ID
-	FromUserName string    `json:"FromUserName" xml:"FromUserName"` // 发送方账号（一个 OpenID，此时发送方是系统账号）
-	CreateTime   int64     `json:"CreateTime" xml:"CreateTime"`     // 消息创建时间（整型），时间戳
-}
-
-// MediaCheckAsyncData 媒体内容安全异步审查结果通知
-type MediaCheckAsyncData struct {
-	CommonPushData
-	Appid   string                `json:"appid" xml:"appid"`
-	TraceID string                `json:"trace_id" xml:"trace_id"`
-	Version int                   `json:"version" xml:"version"`
-	Detail  []*MediaCheckDetail   `json:"detail" xml:"detail"`
-	Errcode int                   `json:"errcode" xml:"errcode"`
-	Errmsg  string                `json:"errmsg" xml:"errmsg"`
-	Result  MediaCheckAsyncResult `json:"result" xml:"result"`
-}
-
-// MediaCheckDetail 检测结果详情
-type MediaCheckDetail struct {
-	Strategy string                `json:"strategy" xml:"strategy"`
-	Errcode  int                   `json:"errcode" xml:"errcode"`
-	Suggest  security.CheckSuggest `json:"suggest" xml:"suggest"`
-	Label    int                   `json:"label" xml:"label"`
-	Prob     int                   `json:"prob" xml:"prob"`
-}
-
-// MediaCheckAsyncResult 检测结果
-type MediaCheckAsyncResult struct {
-	Suggest security.CheckSuggest `json:"suggest" xml:"suggest"`
-	Label   security.CheckLabel   `json:"label" xml:"label"`
-}
-
-// PushDataOrderSettlement 订单将要结算或已经结算通知
-type PushDataOrderSettlement struct {
-	CommonPushData
-	TransactionID           string               `json:"transaction_id" xml:"transaction_id"`                       // 支付订单号
-	MerchantID              string               `json:"merchant_id" xml:"merchant_id"`                             // 商户号
-	SubMerchantID           string               `json:"sub_merchant_id" xml:"sub_merchant_id"`                     // 子商户号
-	MerchantTradeNo         string               `json:"merchant_trade_no" xml:"merchant_trade_no"`                 // 商户订单号
-	PayTime                 int64                `json:"pay_time" xml:"pay_time"`                                   // 支付成功时间，秒级时间戳
-	ShippedTime             int64                `json:"shipped_time" xml:"shipped_time"`                           // 发货时间，秒级时间戳
-	EstimatedSettlementTime int64                `json:"estimated_settlement_time" xml:"estimated_settlement_time"` // 预计结算时间，秒级时间戳。发货时推送才有该字段
-	ConfirmReceiveMethod    ConfirmReceiveMethod `json:"confirm_receive_method" xml:"confirm_receive_method"`       // 确认收货方式：1. 自动确认收货；2. 手动确认收货。结算时推送才有该字段
-	ConfirmReceiveTime      int64                `json:"confirm_receive_time" xml:"confirm_receive_time"`           // 确认收货时间，秒级时间戳。结算时推送才有该字段
-	SettlementTime          int64                `json:"settlement_time" xml:"settlement_time"`                     // 订单结算时间，秒级时间戳。结算时推送才有该字段
-}
-
-// PushDataRemindShipping 提醒需要上传发货信息
-type PushDataRemindShipping struct {
-	CommonPushData
-	TransactionID   string `json:"transaction_id" xml:"transaction_id"`       // 微信支付订单号
-	MerchantID      string `json:"merchant_id" xml:"merchant_id"`             // 商户号
-	SubMerchantID   string `json:"sub_merchant_id" xml:"sub_merchant_id"`     // 子商户号
-	MerchantTradeNo string `json:"merchant_trade_no" xml:"merchant_trade_no"` // 商户订单号
-	PayTime         int64  `json:"pay_time" xml:"pay_time"`                   // 支付成功时间，秒级时间戳
-	Msg             string `json:"msg" xml:"msg"`                             // 消息文本内容
-}
-
-// PushDataRemindAccessAPI 提醒接入发货信息管理服务 API 信息
-type PushDataRemindAccessAPI struct {
-	CommonPushData
-	Msg string `json:"msg" xml:"msg"` // 消息文本内容
-}
-
-// PushDataAddExpressPath 运单轨迹更新信息
-type PushDataAddExpressPath struct {
-	CommonPushData
-	DeliveryID string                          `json:"DeliveryID" xml:"DeliveryID"` // 快递公司 ID
-	WayBillID  string                          `json:"WaybillId" xml:"WaybillId"`   // 运单 ID
-	OrderID    string                          `json:"OrderId" xml:"OrderId"`       // 订单 ID
-	Version    int                             `json:"Version" xml:"Version"`       // 轨迹版本号（整型）
-	Count      int                             `json:"Count" xml:"Count"`           // 轨迹节点数（整型）
-	Actions    []*PushDataAddExpressPathAction `json:"Actions" xml:"Actions"`       // 轨迹节点列表
-}
-
-// PushDataAddExpressPathAction 轨迹节点
-type PushDataAddExpressPathAction struct {
-	ActionTime int64  `json:"ActionTime" xml:"ActionTime"` // 轨迹节点 Unix 时间戳
-	ActionType int    `json:"ActionType" xml:"ActionType"` // 轨迹节点类型
-	ActionMsg  string `json:"ActionMsg" xml:"ActionMsg"`   // 轨迹节点详情
-}
-
-// PushDataSecVodUpload 短剧媒资上传完成
-type PushDataSecVodUpload struct {
-	CommonPushData
-	UploadEvent SecVodUploadEvent `json:"upload_event" xml:"upload_event"` // 上传完成事件
-}
-
-// SecVodUploadEvent 短剧媒资上传完成事件
-type SecVodUploadEvent struct {
-	MediaID       int64  `json:"media_id" xml:"media_id"`             // 媒资 id
-	SourceContext string `json:"source_context" xml:"source_context"` // 透传上传接口中开发者设置的值。
-	ErrCode       int    `json:"errcode" xml:"errcode"`               // 错误码，上传失败时该值非
-	ErrMsg        string `json:"errmsg" xml:"errmsg"`                 // 错误提示
-}
-
-// PushDataSecVodAudit 短剧媒资审核状态
-type PushDataSecVodAudit struct {
-	CommonPushData
-	AuditEvent SecVodAuditEvent `json:"audit_event" xml:"audit_event"` // 审核状态事件
-}
-
-// SecVodAuditEvent 短剧媒资审核状态事件
-type SecVodAuditEvent struct {
-	DramaID       int64            `json:"drama_id" xml:"drama_id"`             // 剧目 id
-	SourceContext string           `json:"source_context" xml:"source_context"` // 透传上传接口中开发者设置的值
-	AuditDetail   DramaAuditDetail `json:"audit_detail" xml:"audit_detail"`     // 剧目审核结果，单独每一集的审核结果可以根据 drama_id 查询剧集详情得到
-}
-
-// DramaAuditDetail 剧目审核结果
-type DramaAuditDetail struct {
-	Status     int   `json:"status" xml:"status"`           // 审核状态，0 为无效值；1 为审核中；2 为最终失败；3 为审核通过；4 为驳回重填
-	CreateTime int64 `json:"create_time" xml:"create_time"` // 提审时间戳
-	AuditTime  int64 `json:"audit_time" xml:"audit_time"`   // 审核时间戳
-}
-
-// PushDataXpayGoodsDeliverNotify 道具发货推送
-type PushDataXpayGoodsDeliverNotify struct {
-	CommonPushData
-	OpenID        string        `json:"OpenId" xml:"OpenId"`               // 用户 openid
-	OutTradeNo    string        `json:"OutTradeNo" xml:"OutTradeNo"`       // 业务订单号
-	Env           int           `json:"Env" xml:"Env"`                     // ，环境配置 0：现网环境（也叫正式环境）1：沙箱环境
-	WeChatPayInfo WeChatPayInfo `json:"WeChatPayInfo" xml:"WeChatPayInfo"` // 微信支付信息 非微信支付渠道可能没有
-	GoodsInfo     GoodsInfo     `json:"GoodsInfo" xml:"GoodsInfo"`         // 道具参数信息
-}
-
-// WeChatPayInfo 微信支付信息
-type WeChatPayInfo struct {
-	MchOrderNo    string `json:"MchOrderNo" xml:"MchOrderNo"`       // 微信支付商户单号
-	TransactionID string `json:"TransactionId" xml:"TransactionId"` // 交易单号（微信支付订单号）
-	PaidTime      int64  `json:"PaidTime" xml:"PaidTime"`           // 用户支付时间，Linux 秒级时间戳
-}
-
-// GoodsInfo 道具参数信息
-type GoodsInfo struct {
-	ProductID   string `json:"ProductId" xml:"ProductId"`     // 道具 ID
-	Quantity    int    `json:"Quantity" xml:"Quantity"`       // 数量
-	OrigPrice   int64  `json:"OrigPrice" xml:"OrigPrice"`     // 物品原始价格（单位：分）
-	ActualPrice int64  `json:"ActualPrice" xml:"ActualPrice"` // 物品实际支付价格（单位：分）
-	Attach      string `json:"Attach" xml:"Attach"`           // 透传信息
-}
-
-// PushDataXpayCoinPayNotify 代币支付推送
-type PushDataXpayCoinPayNotify struct {
-	CommonPushData
-	OpenID        string        `json:"OpenId" xml:"OpenId"`               // 用户 openid
-	OutTradeNo    string        `json:"OutTradeNo" xml:"OutTradeNo"`       // 业务订单号
-	Env           int           `json:"Env" xml:"Env"`                     // ，环境配置 0：现网环境（也叫正式环境）1：沙箱环境
-	WeChatPayInfo WeChatPayInfo `json:"WeChatPayInfo" xml:"WeChatPayInfo"` // 微信支付信息 非微信支付渠道可能没有
-	CoinInfo      CoinInfo      `json:"CoinInfo" xml:"CoinInfo"`           // 代币参数信息
-}
-
-// CoinInfo 代币参数信息
-type CoinInfo struct {
-	Quantity    int    `json:"Quantity" xml:"Quantity"`       // 数量
-	OrigPrice   int64  `json:"OrigPrice" xml:"OrigPrice"`     // 物品原始价格（单位：分）
-	ActualPrice int64  `json:"ActualPrice" xml:"ActualPrice"` // 物品实际支付价格（单位：分）
-	Attach      string `json:"Attach" xml:"Attach"`           // 透传信息
-}
-
-// PushDataSubscribePopup 用户操作订阅通知弹窗事件推送
-type PushDataSubscribePopup struct {
-	CommonPushData
-	subscribeMsgPopupEventList []SubscribeMsgPopupEventList `json:"-"`
-	SubscribeMsgPopupEvent     SubscribeMsgPopupEvent       `xml:"SubscribeMsgPopupEvent"`
-}
-
-// SubscribeMsgPopupEvent 用户操作订阅通知弹窗消息回调
-type SubscribeMsgPopupEvent struct {
-	List []SubscribeMsgPopupEventList `xml:"List"`
-}
-
-// SubscribeMsgPopupEventList 订阅消息事件列表
-type SubscribeMsgPopupEventList struct {
-	TemplateID            string `xml:"TemplateId" json:"TemplateId"`
-	SubscribeStatusString string `xml:"SubscribeStatusString" json:"SubscribeStatusString"`
-	PopupScene            string `xml:"PopupScene" json:"PopupScene"`
-}
-
-// SetSubscribeMsgPopupEvents 设置订阅消息事件
-func (s *PushDataSubscribePopup) SetSubscribeMsgPopupEvents(list []SubscribeMsgPopupEventList) {
-	s.subscribeMsgPopupEventList = list
-}
-
-// GetSubscribeMsgPopupEvents 获取订阅消息事件数据
-func (s *PushDataSubscribePopup) GetSubscribeMsgPopupEvents() []SubscribeMsgPopupEventList {
-	if s.subscribeMsgPopupEventList != nil {
-		return s.subscribeMsgPopupEventList
-	}
-
-	if s.SubscribeMsgPopupEvent.List == nil || len(s.SubscribeMsgPopupEvent.List) < 1 {
-		return nil
-	}
-	return s.SubscribeMsgPopupEvent.List
-}
-
-// PushDataSubscribeMsgChange 用户管理订阅通知事件推送
-type PushDataSubscribeMsgChange struct {
-	CommonPushData
-	SubscribeMsgChangeEvent SubscribeMsgChangeEvent  `xml:"SubscribeMsgChangeEvent"`
-	subscribeMsgChangeList  []SubscribeMsgChangeList `json:"-"`
-}
-
-// SubscribeMsgChangeEvent 用户管理订阅通知回调
-type SubscribeMsgChangeEvent struct {
-	List []SubscribeMsgChangeList `xml:"List" json:"List"`
-}
-
-// SubscribeMsgChangeList 订阅消息事件列表
-type SubscribeMsgChangeList struct {
-	TemplateID            string `xml:"TemplateId" json:"TemplateId"`
-	SubscribeStatusString string `xml:"SubscribeStatusString" json:"SubscribeStatusString"`
-}
-
-// SetSubscribeMsgChangeEvents 设置订阅消息事件
-func (s *PushDataSubscribeMsgChange) SetSubscribeMsgChangeEvents(list []SubscribeMsgChangeList) {
-	s.subscribeMsgChangeList = list
-}
-
-// GetSubscribeMsgChangeEvents 获取订阅消息事件数据
-func (s *PushDataSubscribeMsgChange) GetSubscribeMsgChangeEvents() []SubscribeMsgChangeList {
-	if s.subscribeMsgChangeList != nil {
-		return s.subscribeMsgChangeList
-	}
-
-	if s.SubscribeMsgChangeEvent.List == nil || len(s.SubscribeMsgChangeEvent.List) < 1 {
-		return nil
-	}
-
-	return s.SubscribeMsgChangeEvent.List
-}
-
-// PushDataSubscribeMsgSent 用户发送订阅通知事件推送
-type PushDataSubscribeMsgSent struct {
-	CommonPushData
-	SubscribeMsgSentEvent     SubscribeMsgSentEvent  `xml:"SubscribeMsgSentEvent"`
-	subscribeMsgSentEventList []SubscribeMsgSentList `json:"-"`
-}
-
-// SubscribeMsgSentEvent 用户发送订阅通知回调
-type SubscribeMsgSentEvent struct {
-	List []SubscribeMsgSentList `xml:"List" json:"List"`
-}
-
-// SubscribeMsgSentList 订阅消息事件列表
-type SubscribeMsgSentList struct {
-	TemplateID  string `xml:"TemplateId" json:"TemplateId"`
-	MsgID       string `xml:"MsgID" json:"MsgID"`
-	ErrorCode   int    `xml:"ErrorCode" json:"ErrorCode"`
-	ErrorStatus string `xml:"ErrorStatus" json:"ErrorStatus"`
-}
-
-// SetSubscribeMsgSentEvents 设置订阅消息事件
-func (s *PushDataSubscribeMsgSent) SetSubscribeMsgSentEvents(list []SubscribeMsgSentList) {
-	s.subscribeMsgSentEventList = list
-}
-
-// GetSubscribeMsgSentEvents 获取订阅消息事件数据
-func (s *PushDataSubscribeMsgSent) GetSubscribeMsgSentEvents() []SubscribeMsgSentList {
-	if s.subscribeMsgSentEventList != nil {
-		return s.subscribeMsgSentEventList
-	}
-
-	if s.SubscribeMsgSentEvent.List == nil || len(s.SubscribeMsgSentEvent.List) < 1 {
-		return nil
-	}
-
-	return s.SubscribeMsgSentEvent.List
-}

miniprogram/message/reply.go

@@ -1,15 +0,0 @@
-package message
-
-import "errors"
-
-// ErrInvalidReply 无效的回复
-var ErrInvalidReply = errors.New("无效的回复信息")
-
-// ErrUnsupportedReply 不支持的回复类型
-var ErrUnsupportedReply = errors.New("不支持的回复消息")
-
-// Reply 消息回复
-type Reply struct {
-	MsgType MsgType
-	MsgData interface{}
-}

miniprogram/message/updatable_msg.go

@@ -1,102 +0,0 @@
-package message
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	// createActivityURL 创建activity_id
-	createActivityURL = "https://api.weixin.qq.com/cgi-bin/message/wxopen/activityid/create?access_token=%s"
-	// SendUpdatableMsgURL 修改动态消息
-	setUpdatableMsgURL = "https://api.weixin.qq.com/cgi-bin/message/wxopen/updatablemsg/send?access_token=%s"
-)
-
-// UpdatableTargetState 动态消息状态
-type UpdatableTargetState int
-
-const (
-	// TargetStateNotStarted 未开始
-	TargetStateNotStarted UpdatableTargetState = 0
-	// TargetStateStarted 已开始
-	TargetStateStarted UpdatableTargetState = 1
-	// TargetStateFinished 已结束
-	TargetStateFinished UpdatableTargetState = 2
-)
-
-// UpdatableMessage 动态消息
-type UpdatableMessage struct {
-	*context.Context
-}
-
-// NewUpdatableMessage 实例化
-func NewUpdatableMessage(ctx *context.Context) *UpdatableMessage {
-	return &UpdatableMessage{
-		Context: ctx,
-	}
-}
-
-// CreateActivityID 创建activity_id
-func (updatableMessage *UpdatableMessage) CreateActivityID() (res CreateActivityIDResponse, err error) {
-	accessToken, err := updatableMessage.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(createActivityURL, accessToken)
-	response, err := util.HTTPGet(uri)
-	if err != nil {
-		return
-	}
-	err = util.DecodeWithError(response, &res, "CreateActivityID")
-	return
-}
-
-// SetUpdatableMsg 修改动态消息
-func (updatableMessage *UpdatableMessage) SetUpdatableMsg(activityID string, targetState UpdatableTargetState, template UpdatableMsgTemplate) (err error) {
-	accessToken, err := updatableMessage.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(setUpdatableMsgURL, accessToken)
-	data := SendUpdatableMsgReq{
-		ActivityID:   activityID,
-		TargetState:  targetState,
-		TemplateInfo: template,
-	}
-
-	response, err := util.PostJSON(uri, data)
-	if err != nil {
-		return
-	}
-	return util.DecodeWithCommonError(response, "SendUpdatableMsg")
-}
-
-// CreateActivityIDResponse 创建activity_id 返回
-type CreateActivityIDResponse struct {
-	util.CommonError
-
-	ActivityID     string `json:"activity_id"`
-	ExpirationTime int64  `json:"expiration_time"`
-}
-
-// UpdatableMsgTemplate 动态消息模板
-type UpdatableMsgTemplate struct {
-	ParameterList []UpdatableMsgParameter `json:"parameter_list"`
-}
-
-// UpdatableMsgParameter 动态消息参数
-type UpdatableMsgParameter struct {
-	Name  string `json:"name"`
-	Value string `json:"value"`
-}
-
-// SendUpdatableMsgReq 修改动态消息参数
-type SendUpdatableMsgReq struct {
-	ActivityID   string               `json:"activity_id"`
-	TemplateInfo UpdatableMsgTemplate `json:"template_info"`
-	TargetState  UpdatableTargetState `json:"target_state"`
-}

miniprogram/minidrama/constant.go

@@ -1,100 +0,0 @@
-/*
- *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- *
- *    You can obtain one at https://github.com/silenceper/wechat.
- *
- */
-
-package minidrama
-
-const (
-	// Success 错误码 0、成功
-	Success ErrCode = 0
-	// SystemError 错误码 -1、系统错误
-	SystemError ErrCode = -1
-	// InitError 错误码 -2 初始化未完成，请稍后再试
-	InitError ErrCode = -2
-	// FormatError 错误码 47001	输入格式错误
-	FormatError ErrCode = 47001
-	// ParamError 错误码 47003	参数不符合要求
-	ParamError ErrCode = 47003
-	// PostError 错误码 44002	POST 内容为空
-	PostError ErrCode = 44002
-	// MethodError 错误码 43002	HTTP 请求必须使用 POST 方法
-	MethodError ErrCode = 43002
-	// VideoTypeError 错误码 10090001	视频类型不支持
-	VideoTypeError ErrCode = 10090001
-	// ImageTypeError 错误码 10090002	图片类型不支持
-	ImageTypeError ErrCode = 10090002
-	// ImageURLError 错误码 10090003	图片 URL 无效
-	ImageURLError ErrCode = 10090003
-	// ResourceType 错误码 10090005	resource_type 无效
-	ResourceType ErrCode = 10090005
-	// OperationError 错误码 10093011	操作失败
-	OperationError ErrCode = 10093011
-	// ParamError2 错误码 10093014	参数错误（包括参数格式、类型等错误）
-	ParamError2 ErrCode = 10093014
-	// OperationFrequentError 错误码 10093023	操作过于频繁
-	OperationFrequentError ErrCode = 10093023
-	// ResourceNotExistError 错误码 10093030	资源不存在
-	ResourceNotExistError ErrCode = 10093030
-)
-
-const (
-	// singleFileUpload 单个文件上传，上传媒体（和封面）文件，上传小文件（小于 10MB）时使用。上传大文件请使用分片上传接口。
-	singleFileUpload = "https://api.weixin.qq.com/wxa/sec/vod/singlefileupload?access_token="
-
-	// pullUpload 拉取上传，该接口用于将一个网络上的视频拉取上传到平台。
-	pullUpload = "https://api.weixin.qq.com/wxa/sec/vod/pullupload?access_token="
-
-	// getTask 查询任务，该接口用于查询拉取上传的任务状态。
-	getTask = "https://api.weixin.qq.com/wxa/sec/vod/gettask?access_token="
-
-	// applyUpload 申请分片上传
-	applyUpload = "https://api.weixin.qq.com/wxa/sec/vod/applyupload?access_token="
-
-	// uploadPart 上传分片
-	uploadPart = "https://api.weixin.qq.com/wxa/sec/vod/uploadpart?access_token="
-
-	// commitUpload 确认上传，该接口用于完成整个分片上传流程，合并所有文件分片，确认媒体文件（和封面图片文件）上传到平台的结果，返回文件的 ID。请求中需要给出每一个分片的 part_number 和 etag，用来校验分片的准确性。
-	commitUpload = "https://api.weixin.qq.com/wxa/sec/vod/commitupload?access_token="
-
-	// listMedia 获取媒体列表
-	listMedia = "https://api.weixin.qq.com/wxa/sec/vod/listmedia?access_token="
-
-	// getMedia 获取媒资详细信息，该接口用于获取已上传到平台的指定媒资信息，用于开发者后台管理使用。用于给用户客户端播放的链接应该使用 getmedialink 接口获取。
-	getMedia = "https://api.weixin.qq.com/wxa/sec/vod/getmedia?access_token="
-
-	// getMediaLink 获取媒资播放链接，该接口用于获取视频临时播放链接，用于给用户的播放使用。只有审核通过的视频才能通过该接口获取播放链接。
-	getMediaLink = "https://api.weixin.qq.com/wxa/sec/vod/getmedialink?access_token="
-
-	// deleteMedia 删除媒体，该接口用于删除指定媒资。
-	deleteMedia = "https://api.weixin.qq.com/wxa/sec/vod/deletemedia?access_token="
-
-	// auditDrama 审核剧本
-	auditDrama = "https://api.weixin.qq.com/wxa/sec/vod/auditdrama?access_token="
-
-	// listDramas 获取剧目列表
-	listDramas = "https://api.weixin.qq.com/wxa/sec/vod/listdramas?access_token="
-
-	// getDrama 获取剧目信息，该接口用于查询已提交的剧目。
-	getDrama = "https://api.weixin.qq.com/wxa/sec/vod/getdrama?access_token="
-
-	// getCdnUsageData 查询 CDN 用量数据，该接口用于查询点播 CDN 的流量数据。
-	getCdnUsageData = "https://api.weixin.qq.com/wxa/sec/vod/getcdnusagedata?access_token="
-
-	// getCdnLogs 查询 CDN 日志，该接口用于查询点播 CDN 的日志。
-	getCdnLogs = "https://api.weixin.qq.com/wxa/sec/vod/getcdnlogs?access_token="
-)

miniprogram/minidrama/doc.go

@@ -1,32 +0,0 @@
-/*
- *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
- *
- *   Licensed under the Apache License, Version 2.0 (the "License");
- *   you may not use this file except in compliance with the License.
- *   You may obtain a copy of the License at
- *
- *       http://www.apache.org/licenses/LICENSE-2.0
- *
- *   Unless required by applicable law or agreed to in writing, software
- *   distributed under the License is distributed on an "AS IS" BASIS,
- *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *   See the License for the specific language governing permissions and
- *   limitations under the License.
- *
- *   You can obtain one at https://github.com/silenceper/wechat.
- *
- */
-
-// Package minidrama Mini Program entertainment mini-drama related interface
-package minidrama
-
-import (
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-)
-
-// NewMiniDrama 实例化小程序娱乐直播 API
-func NewMiniDrama(ctx *context.Context) *MiniDrama {
-	return &MiniDrama{
-		ctx: ctx,
-	}
-}

miniprogram/minidrama/domain.go

@@ -1,440 +0,0 @@
-/*
- *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- *
- *    You can obtain one at https://github.com/silenceper/wechat.
- *
- */
-
-package minidrama
-
-import (
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-// MiniDrama mini program entertainment live broadcast related
-type MiniDrama struct {
-	ctx *context.Context
-}
-
-// ErrCode error code
-type ErrCode int
-
-// SingleFileUploadRequest 单文件上传请求
-// Content-Type 需要指定为 multipart/form-data; boundary=<delimiter>
-// <箭头括号> 表示必须替换为有效值的变量。
-// 不填写 cover_type，cover_data 字段时默认截取视频首帧作为视频封面。
-type SingleFileUploadRequest struct {
-	MediaName     string `json:"media_name"`               // 媒体文件名称 文件名，需按照“剧目名 - 对应剧集数”格式命名文件，示例值："我的演艺 - 第 1 集"。
-	MediaType     string `json:"media_type"`               // 媒体文件类型 视频格式，支持：MP4，TS，MOV，MXF，MPG，FLV，WMV，AVI，M4V，F4V，MPEG，3GP，ASF，MKV，示例值："MP4"。
-	MediaData     []byte `json:"media_data"`               // 媒体文件数据 视频文件内容，二进制。
-	CoverType     string `json:"cover_type,omitempty"`     // 视频封面图片格式，支持：JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF，示例值："JPG"。
-	CoverData     []byte `json:"cover_data,omitempty"`     // 视频封面图片内容，二进制。
-	SourceContext string `json:"source_context,omitempty"` // 来源上下文，会在上传完成事件中透传给开发者。
-}
-
-// SingleFileUploadResponse 单文件上传响应
-type SingleFileUploadResponse struct {
-	util.CommonError
-	MediaID int64 `json:"media_id"` // 媒体文件唯一标识，用于发布视频。
-}
-
-// PullUploadRequest 拉取上传请求
-// 不填写 cover_url 字段时默认截取视频首帧作为封面。
-// Content-Type 需要指定为 application/json
-// 该接口为异步接口，上传完成会推送上传完成事件到开发者服务器，开发者也可以调用"查询任务"接口来轮询上传结果。
-type PullUploadRequest struct {
-	MediaName     string `json:"media_name"`               // 媒体文件名称 文件名，需按照“剧目名 - 对应剧集数”格式命名文件，示例值："我的演艺 - 第 1 集"。
-	MediaURL      string `json:"media_url"`                // 视频 URL，示例值："https://developers.weixin.qq.com/test.mp4"。
-	CoverURL      string `json:"cover_url,omitempty"`      // 视频封面 URL，示例值："https://developers.weixin.qq.com/test.jpg"。
-	SourceContext string `json:"source_context,omitempty"` // 来源上下文，会在上传完成事件中透传给开发者。
-}
-
-// PullUploadResponse 拉取上传响应
-type PullUploadResponse struct {
-	util.CommonError
-	TaskID int64 `json:"task_id"` // 任务 ID，用于查询拉取上传任务的结果。
-}
-
-// GetTaskRequest 查询任务请求
-// 该接口用于查询拉取上传的任务状态。
-// Content-Type 需要指定为 application/json。
-type GetTaskRequest struct {
-	TaskID int64 `json:"task_id"` // 任务 ID，用于查询拉取上传任务的结果。
-}
-
-// GetTaskResponse 查询任务响应
-type GetTaskResponse struct {
-	util.CommonError
-	TaskInfo TaskInfo `json:"task_info"` // 任务信息。
-}
-
-// TaskInfo 任务信息
-type TaskInfo struct {
-	ID         int64  `json:"id"`          // 任务 ID。
-	TaskType   int    `json:"task_type"`   // 任务类型，1：拉取上传任务。
-	Status     int    `json:"status"`      // 任务状态枚举值：1. 等待中；2. 正在处理；3. 已完成；4. 失败。
-	ErrCode    int    `json:"errcode"`     // 任务错误码，0 表示成功，其它表示失败。
-	ErrMsg     string `json:"errmsg"`      // 任务错误原因。
-	CreateTime int64  `json:"create_time"` // 任务创建时间，时间戳，单位：秒。
-	FinishTime int64  `json:"finish_time"` // 任务完成时间，时间戳，单位：秒。
-	MediaID    int64  `json:"media_id"`    // 媒体文件唯一标识，用于发布视频。
-}
-
-// ApplyUploadRequest 申请上传请求
-// 上传大文件时需使用分片上传方式，分为 3 个步骤：
-//
-// 申请分片上传，确定文件名、格式类型，返回 upload_id，唯一标识本次分片上传。
-// 上传分片，多次调用上传文件分片，需要携带 part_number 和 upload_id，其中 part_number 为分片的编号，支持乱序上传。当传入 part_number 和 upload_id 都相同的时候，后发起上传请求的分片将覆盖之前的分片。
-// 确认分片上传，当上传完所有分片后，需要完成整个文件的合并。请求体中需要给出每一个分片的 part_number 和 etag，用来校验分片的准确性，最后返回文件的 media_id。
-// 如果填写了 cover_type，表明本次分片上传除上传媒体文件外还需要上传封面图片，不填写 cover_type 则默认截取视频首帧作为封面。
-// Content-Type 需要指定为 application/json。
-type ApplyUploadRequest struct {
-	MediaName     string `json:"media_name"`               // 媒体文件名称 文件名，需按照“剧目名 - 对应剧集数”格式命名文件，示例值："我的演艺 - 第 1 集"。
-	MediaType     string `json:"media_type"`               // 媒体文件类型 视频格式，支持：MP4，TS，MOV，MXF，MPG，FLV，WMV，AVI，M4V，F4V，MPEG，3GP，ASF，MKV，示例值："MP4"。
-	CoverType     string `json:"cover_type,omitempty"`     // 视频封面图片格式，支持：JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF，示例值："JPG"。
-	SourceContext string `json:"source_context,omitempty"` // 来源上下文，会在上传完成事件中透传给开发者。
-}
-
-// ApplyUploadResponse 申请上传响应
-type ApplyUploadResponse struct {
-	util.CommonError
-	UploadID string `json:"upload_id"` // 本次分片上传的唯一标识。
-}
-
-// UploadPartRequest 上传分片请求
-// 将文件的其中一个分片上传到平台，最多支持 100 个分片，每个分片大小为 5MB，最后一个分片可以小于 5MB。该接口适用于视频和封面图片。视频最大支持 500MB，封面图片最大支持 10MB。
-// 调用该接口之前必须先调用申请分片上传接口。
-// 在申请分片上传时，如果不填写 cover_type，则默认截取视频首帧作为封面。
-// Content-Type 需要指定为 multipart/form-data; boundary=<delimiter>，<箭头括号>表示必须替换为有效值的变量。
-// part_number 从 1 开始。如除了上传视频外还需要上传封面图片，则封面图片的 part_number 需重新从 1 开始编号。
-type UploadPartRequest struct {
-	UploadID     string `json:"upload_id"`     // 一次分片上传的唯一标识，由申请分片上传接口返回。
-	PartNumber   int    `json:"part_number"`   // 本次上传的分片的编号，范围在 1 - 100。
-	ResourceType int    `json:"resource_type"` // 指定该分片属于视频还是封面图片的枚举值：1. 视频，2. 封面图片。
-	Data         []byte `json:"data"`          // 分片内容，二进制。
-}
-
-// UploadPartResponse 上传分片响应
-type UploadPartResponse struct {
-	util.CommonError
-	ETag string `json:"etag"` // 上传分片成功后返回的分片标识，用于后续确认分片上传接口。
-}
-
-// CommitUploadRequest 确认分片上传请求
-// 该接口用于完成整个分片上传流程，合并所有文件分片，确认媒体文件（和封面图片文件）上传到平台的结果，返回文件的 ID。请求中需要给出每一个分片的 part_number 和 etag，用来校验分片的准确性。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 调用该接口之前必须先调用申请分片上传接口以及上传分片接口。
-// 如本次分片上传除上传媒体文件外还需要上传封面图片，则请求中还需提供 cover_part_infos 字段以用于合并封面图片文件分片。
-// 请求中 media_part_infos 和 cover_part_infos 字段必须按 part_number 从小到大排序，part_number 必须从 1 开始，连续且不重复。
-type CommitUploadRequest struct {
-	UploadID       string      `json:"upload_id"`
-	MediaPartInfos []*PartInfo `json:"media_part_infos"`
-	CoverPartInfos []*PartInfo `json:"cover_part_infos,omitempty"`
-}
-
-// PartInfo 分片信息
-type PartInfo struct {
-	PartNumber int    `json:"part_number"` // 分片编号。
-	Etag       string `json:"etag"`        // 使用上传分片接口上传成功后返回的 etag 的值
-}
-
-// CommitUploadResponse 确认分片上传响应
-type CommitUploadResponse struct {
-	util.CommonError
-	MediaID int64 `json:"media_id"` // 媒体文件唯一标识，用于发布视频。
-}
-
-// ListMediaRequest 查询媒体列表请求
-// 该接口用于查询已经上传到平台的媒体文件列表。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 本接口返回的视频或图片链接均为临时链接，不应将其保存下来。
-// media_name 参数支持模糊匹配，当需要模糊匹配时可以在前面或后面加上 %，否则为精确匹配。例如 "test%" 可以匹配到 "test123", "testxxx", "test"。
-// 调用方式
-type ListMediaRequest struct {
-	DramaID   int64  `json:"drama_id,omitempty"`   // 剧目 ID，可通过查询剧目列表接口获取。
-	MediaName string `json:"media_name,omitempty"` // 媒体文件名称，可通过查询媒体列表接口获取，模糊匹配。
-	StartTime int64  `json:"start_time,omitempty"` // 媒资上传时间>=start_time，Unix 时间戳，单位：秒。
-	EndTime   int64  `json:"end_time,omitempty"`   // 媒资上传时间<end_time，Unix 时间戳，单位：秒。
-	Limit     int    `json:"limit,omitempty"`      // 分页拉取的最大返回结果数。默认值：100；最大值：100。
-	Offset    int    `json:"offset,omitempty"`     // 分页拉取的起始偏移量。默认值：0。
-}
-
-// MediaInfo 媒体信息
-type MediaInfo struct {
-	MediaID     int64             `json:"media_id"`     // 媒资文件 id。
-	CreateTime  int64             `json:"create_time"`  // 	上传时间，时间戳。
-	ExpireTime  int64             `json:"expire_time"`  // 过期时间，时间戳。
-	DramaID     int64             `json:"drama_id"`     // 所属剧目 id。
-	FileSize    int64             `json:"file_size"`    // 媒资文件大小，单位：字节。
-	Duration    int64             `json:"duration"`     // 播放时长，单位：秒。
-	Name        string            `json:"name"`         // 媒资文件名。
-	Description string            `json:"description"`  // 描述。
-	CoverURL    string            `json:"cover_url"`    // 封面图临时链接。
-	OriginalURL string            `json:"original_url"` // 原始视频临时链接。
-	Mp4URL      string            `json:"mp4_url"`      // mp4 格式临时链接。
-	HlsURL      string            `json:"hls_url"`      // hls 格式临时链接。
-	AuditDetail *MediaAuditDetail `json:"audit_detail"` // 审核信息。
-}
-
-// MediaAuditDetail 媒体审核详情
-type MediaAuditDetail struct {
-	Status                 int      `json:"status"`                    // 审核状态 0 为无效值；1 为审核中；2 为审核驳回；3 为审核通过；4 为驳回重填。需要注意可能存在单个剧集的状态为审核通过，但是剧目整体是未通过的情况，而能不能获取播放链接取决于剧目的审核状态。
-	CreateTime             int      `json:"create_time"`               // 提审时间戳。
-	AuditTime              int      `json:"audit_time"`                // 审核时间戳。
-	Reason                 string   `json:"reason"`                    // 审核备注。该值可能为空。
-	EvidenceMaterialIDList []string `json:"evidence_material_id_list"` // 审核证据截图 id 列表，截图 id 可以用作 get_material 接口的参数来获得截图内容。
-}
-
-// ListMediaResponse 查询媒体列表响应
-type ListMediaResponse struct {
-	util.CommonError
-	MediaInfoList []*MediaInfo `json:"media_info_list"` // 媒体信息列表。
-}
-
-// GetMediaRequest 获取媒体请求
-// 该接口用于获取已上传到平台的指定媒资信息，用于开发者后台管理使用。用于给用户客户端播放的链接应该使用 getmedialink 接口获取。
-// Content-Type 需要指定为 application/json。
-// 本接口返回的视频或图片链接均为临时链接，不应将其保存下来。
-type GetMediaRequest struct {
-	MediaID int64 `json:"media_id"` // 媒资文件 id。
-}
-
-// GetMediaResponse 获取媒体响应
-type GetMediaResponse struct {
-	util.CommonError
-	MediaInfo MediaInfo `json:"media_info"` // 媒体信息。
-}
-
-// GetMediaLinkRequest 获取媒体链接请求
-// 该接口用于获取视频临时播放链接，用于给用户的播放使用。只有审核通过的视频才能通过该接口获取播放链接。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 本接口返回的视频或图片链接均为临时链接，不应将其保存下来。
-// 能不能获取播放链接取决于剧目审核状态，可能存在单个剧集的状态为审核通过，但是剧目整体是未通过的情况，这种情况也没法获取播放链接。
-// 开发者如需区分不同渠道的播放流量或次数，可以在 us 参数中传入渠道标识，这样得到的播放链接中 us 参数的前半部分就包含有渠道标识。开发者把这个带有渠道标识的链接分发给对应的渠道播放，就能统计到不同渠道播放情况。统计的数据来源为 CDN 日志（从 getcdnlogs 接口得到），CDN 日志中“文件路径”列中的参数也带有该标识，再结合日志中“字节数”列的流量数值，估算每个渠道所消耗的流量。另需注意日志统计的流量和扣费流量的差异，详情参考 getcdnlogs 接口中的注意事项。
-type GetMediaLinkRequest struct {
-	MediaID int64  `json:"media_id"`         // 媒资文件 id。
-	T       int64  `json:"t"`                // 播放地址的过期时间戳。有效的时间最长不能超过 2 小时后。
-	US      string `json:"us,omitempty"`     // 链接标识。平台默认会生成一个仅包含小写字母和数字的字符串用于增强链接的唯一性 (如 us=647488c4792c15185b8fd2a6)。如开发者需要增加自己的标识，比如区分播放的渠道，可使用该参数，该参数最终的值是"开发者标识 - 平台标识"（如开发者传入 abcd，则最终的临时链接中 us=abcd-647488c4792c15185b8fd2a6）
-	Expr    int    `json:"expr,omitempty"`   // 试看时长，单位：秒，最大值不能超过视频长度
-	RLimit  int    `json:"rlimit,omitempty"` // 最多允许多少个不同 IP 的终端播放，以十进制表示，最大值为 9，不填表示不做限制。当限制 URL 只能被 1 个人播放时，建议 rlimit 不要严格限制成 1（例如可设置为 3），因为移动端断网后重连 IP 可能改变。
-	WHref   string `json:"whref,omitempty"`  // 允许访问的域名列表，支持 1 条 - 10 条，用半角逗号分隔。域名前不要带协议名（http://和 https://），域名为前缀匹配（如填写 abc.com，则 abc.com/123 和 abc.com.cn 也会匹配），且支持通配符（如 *.abc.com）
-	BkRef   string `json:"bkref,omitempty"`  // 禁止访问的域名列表，支持 1 条 - 10 条，用半角逗号分隔。域名前不要带协议名（http://和 https://），域名为前缀匹配（如填写 abc.com，则 abc.com/123 和 abc.com.cn 也会匹配），且支持通配符（如 *.abc.com）。
-}
-
-// GetMediaLinkResponse 获取媒体链接响应
-type GetMediaLinkResponse struct {
-	util.CommonError
-	MediaInfo MediaPlaybackInfo `json:"media_info"` // 媒体播放信息。
-}
-
-// MediaPlaybackInfo 媒体播放信息
-type MediaPlaybackInfo struct {
-	MediaID     int64  `json:"media_id"`    // 媒资文件 id。
-	Duration    int64  `json:"duration"`    // 播放时长，单位：秒。
-	Name        string `json:"name"`        // 媒资文件名。
-	Description string `json:"description"` // 描述。
-	CoverURL    string `json:"cover_url"`   // 封面图临时链接。
-	Mp4URL      string `json:"mp4_url"`     // mp4 格式临时链接。
-	HlsURL      string `json:"hls_url"`     // hls 格式临时链接。
-}
-
-// DeleteMediaRequest 删除媒体请求
-// 该接口用于删除已上传到平台的指定媒资文件，用于开发者后台管理使用。
-// Content-Type 需要指定为 application/json。
-type DeleteMediaRequest struct {
-	MediaID int64 `json:"media_id"` // 媒资文件 id。
-}
-
-// DeleteMediaResponse 删除媒体响应
-type DeleteMediaResponse struct {
-	util.CommonError
-}
-
-// AuditDramaRequest 审核剧目请求
-// 该接口用于审核剧目，审核通过后，剧目下所有剧集都会被审核通过。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 剧目信息与审核材料在首次提审时为必填，重新提审时根据是否需要修改选填，
-// 本接口中使用的临时图片 material_id 可通过新增临时素材接口上传得到，对应临时素材接口中的 media_id，本文档中为避免与剧集的 media_id 混淆，称其为 material_id。
-// 新增临时素材接口可以被小程序调用，调用的小程序账号和剧目提审的小程序账号必须是同一个，否则提交审核时会无法识别素材 id。
-type AuditDramaRequest struct {
-	DramaID                  int64          `json:"drama_id,omitempty"`                    // 剧目 ID，可通过查询剧目列表接口获取。首次提审不需要填该参数，重新提审时必填
-	Name                     string         `json:"name,omitempty"`                        // 剧名，首次提审时必填，重新提审时根据是否需要修改选填。
-	MediaCount               int            `json:"media_count,omitempty"`                 // 剧集数目。首次提审时必填，重新提审时可不填，如要填写也要和第一次提审时一样。
-	MediaIDList              []int64        `json:"media_id_list,omitempty"`               // 剧集媒资 media_id 列表。首次提审时必填，而且元素个数必须与 media_count 一致。重新提审时为可选，如果剧集有内容有变化，可以通过新的列表替换未通过的剧集（推荐使用 replace_media_list 进行替换，避免顺序和原列表不一致）。
-	Producer                 string         `json:"producer,omitempty"`                    // 制作方。首次提审时必填，重新提审时根据是否需要修改选填。
-	Description              string         `json:"description,omitempty"`                 // 剧描述。首次提审时必填，重新提审时根据是否需要修改选填。
-	CoverMaterialID          string         `json:"cover_material_id,omitempty"`           // 封面图片临时 media_id。首次提审时必填，重新提审时根据是否需要修改选填。
-	RegistrationNumber       string         `json:"registration_number,omitempty"`         // 剧目备案号。首次提审时剧目备案号与网络剧片发行许可证编号二选一。重新提审时根据是否需要修改选填
-	AuthorizedMaterialID     string         `json:"authorized_material_id,omitempty"`      // 剧目播放授权材料 material_id。如果小程序主体名称和制作方完全一致，则不需要填，否则必填
-	PublishLicense           string         `json:"publish_license,omitempty"`             // 网络剧片发行许可证编号。首次提审时剧目备案号与网络剧片发行许可证编号二选一。重新提审时根据是否需要修改选填
-	PublishLicenseMaterialID string         `json:"publish_license_material_id,omitempty"` // 网络剧片发行许可证图片，首次提审时如果网络剧片发行许可证编号非空，则该改字段也非空。重新提审时根据是否变化选填
-	Expedited                int            `json:"expedited,omitempty"`                   // 是否加急审核，填 1 表示审核加急，0 或不填为不加急。每天有 5 次加急机会。该字段在首次提审时才有效，重新提审时会沿用首次提审时的属性，重新提审不会扣次数。最终是否为加急单，可以根据 DramaInfo.expedited 属性判断
-	ReplaceMediaList         []*ReplaceInfo `json:"replace_media_list,omitempty"`          // 重新提审时，如果剧目内容有变化，可以通过该字段替换未通过的剧集。用于重新提审时替换审核不通过的剧集。
-}
-
-// ReplaceInfo 替换信息
-type ReplaceInfo struct {
-	Old int64 `json:"old"` // 旧的 media_id
-	New int64 `json:"new"` // 新的 media_id
-}
-
-// AuditDramaResponse 审核剧目响应
-type AuditDramaResponse struct {
-	util.CommonError
-	DramaID int64 `json:"drama_id"` // 剧目 ID。
-}
-
-// ListDramasRequest 查询剧目列表请求
-// 该接口用于获取已提交的剧目列表。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 本接口返回的图片链接均为临时链接，不应将其保存下来。
-// 如果剧目审核结果为失败或驳回，则具体每一集的具体驳回理由及证据截图可通过“获取媒资列表”或者“获取媒资详细信息”接口来获取。
-type ListDramasRequest struct {
-	Limit  int `json:"limit,omitempty"`  // 分页拉取的最大返回结果数。默认值：100；最大值：100。
-	Offset int `json:"offset,omitempty"` // 分页拉取的起始偏移量。默认值：0。
-}
-
-// DramaInfo 剧目信息
-type DramaInfo struct {
-	DramaID           int64             `json:"drama_id"`           // 剧目 id。
-	CreateTime        int64             `json:"create_time"`        // 创建时间，时间戳。
-	Name              string            `json:"name"`               // 	剧名。
-	Playwright        string            `json:"playwright"`         // 编剧。
-	Producer          string            `json:"producer"`           // 制作方。
-	ProductionLicense string            `json:"production_license"` // 广播电视节目制作经营许可证。
-	CoverURL          string            `json:"cover_url"`          // 封面图临时链接，根据提审时提交的 cover_material_id 转存得到。
-	MediaCount        int               `json:"media_count"`        // 剧集数目。
-	Description       string            `json:"description"`        // 剧描述。
-	MediaList         []*DramaMediaInfo `json:"media_list"`         // 剧集信息列表。
-	AuditDetail       *DramaAuditDetail `json:"audit_detail"`       // 审核状态。
-	Expedited         int               `json:"expedited"`          // 是否加急审核，1 表示审核加急，0 或空为非加急审核。
-}
-
-// DramaMediaInfo 剧目媒体信息
-type DramaMediaInfo struct {
-	MediaID int64 `json:"media_id"`
-}
-
-// DramaAuditDetail 剧目审核详情
-type DramaAuditDetail struct {
-	Status     int   `json:"status"`      // 审核状态 0 为无效值；1 为审核中；2 为审核驳回；3 为审核通过；4 为驳回重填。
-	CreateTime int64 `json:"create_time"` // 提审时间戳。
-	AuditTime  int64 `json:"audit_time"`  // 审核时间戳。
-}
-
-// ListDramasResponse 查询剧目列表响应
-type ListDramasResponse struct {
-	util.CommonError
-	DramaInfoList []*DramaInfo `json:"drama_info_list"` // 剧目信息列表。
-}
-
-// GetDramaRequest 获取剧目请求
-// 该接口用于查询已提交的剧目。
-// 注意事项
-// Content-Type 需要指定为 application/json。
-// 本接口返回的图片链接均为临时链接，不应将其保存下来。
-// 如果剧目审核结果为失败或驳回，则具体每一集的具体驳回理由及证据截图可通过“获取媒资列表”或者“获取媒资详细信息”接口来获取。
-type GetDramaRequest struct {
-	DramaID int64 `json:"drama_id"` // 剧目 id。
-}
-
-// GetDramaResponse 获取剧目响应
-type GetDramaResponse struct {
-	util.CommonError
-	DramaInfo *DramaInfo `json:"drama_info"` // 剧目信息。
-}
-
-// GetCdnUsageDataRequest 获取 CDN 用量数据请求
-// 该接口用于查询点播 CDN 的流量数据。
-// 注意事项
-// 可以查询最近 365 天内的 CDN 用量数据。
-// 查询时间跨度不超过 90 天。
-// 可以指定用量数据的时间粒度，支持 5 分钟、1 小时、1 天的时间粒度。
-// 流量为查询时间粒度内的总流量。
-type GetCdnUsageDataRequest struct {
-	StartTime    int64 `json:"start_time"`    // 查询起始时间，Unix 时间戳，单位：秒。
-	EndTime      int64 `json:"end_time"`      // 查询结束时间，Unix 时间戳，单位：秒。
-	DataInterval int   `json:"data_interval"` // 用量数据的时间粒度，单位：分钟，取值有：5:5 分钟粒度，返回指定查询时间内 5 分钟粒度的明细数据。60：小时粒度，返回指定查询时间内 1 小时粒度的数据。1440：天粒度，返回指定查询时间内 1 天粒度的数据。默认值为 1440，返回天粒度的数据。
-}
-
-// DataItem 数据项
-type DataItem struct {
-	Time  int64 `json:"time"`  // 时间戳，单位：秒。
-	Value int64 `json:"value"` // 用量数值。
-}
-
-// GetCdnUsageDataResponse 获取 CDN 用量数据响应
-type GetCdnUsageDataResponse struct {
-	util.CommonError
-	DataInterval int         `json:"data_interval"`
-	ItemList     []*DataItem `json:"item_list"`
-}
-
-// GetCdnLogsRequest 获取 CDN 日志下载链接请求
-// 该接口用于获取点播 CDN 日志下载链接。
-// 注意事项
-// 可以查询最近 30 天内的 CDN 日志下载链接。
-// 默认情况下 CDN 每小时生成一个日志文件，如果某一个小时没有 CDN 访问，不会生成日志文件。
-// CDN 日志下载链接的有效期为 24 小时。
-// 日志字段依次为：请求时间、客户端 IP、访问域名、文件路径、字节数、省级编码、运营商编码、HTTP 状态码、referer、Request-Time、UA、range、HTTP Method、协议标识、缓存 HIT / MISS，日志数据打包存在延迟，正常情况下 3 小时后数据包趋于完整日志中的字节数为应用层数据大小，未考虑网络协议包头、加速重传等开销，因此与计费数据存在一定差异。
-// CDN 日志中记录的下行字节数统计而来的流量数据，是应用层数据。在实际网络传输中，产生的网络流量要比纯应用层流量多 5%-15%，比如 TCP/IP 协议的包头消耗、网络丢包重传等，这些无法被应用层统计到。在业内标准中，计费用流量一般在应用层流量的基础上加上上述开销，媒资管理服务中计费的加速流量约为日志计算加速流量的 110%。
-// 省份映射
-// 22：北京；86：内蒙古；146：山西；1069：河北；1177：天津；119：宁夏；152：陕西；1208：甘肃；1467：青海；1468：新疆；145：黑龙江；1445：吉林；1464：辽宁；2：福建；120：江苏；121：安徽；122：山东；1050：上海；1442：浙江；182：河南；1135：湖北；1465：江西；1466：湖南；118：贵州；153：云南；1051：重庆；1068：四川；1155：西藏；4：广东；173：广西；1441：海南；0：其他；1：港澳台；-1：海外。
-// 运营商映射
-// 2：中国电信；26：中国联通；38：教育网；43：长城宽带；1046：中国移动；3947：中国铁通；-1：海外运营商；0：其他运营商。
-type GetCdnLogsRequest struct {
-	StartTime int64 `json:"start_time"`       // 查询起始时间，Unix 时间戳，单位：秒。
-	EndTime   int64 `json:"end_time"`         // 查询结束时间，Unix 时间戳，单位：秒。
-	Limit     int   `json:"limit,omitempty"`  // 分页拉取的最大返回结果数。默认值：100；最大值：100。
-	Offset    int   `json:"offset,omitempty"` // 分页拉取的起始偏移量。默认值：0。
-}
-
-// CdnLogInfo CDN 日志信息
-type CdnLogInfo struct {
-	Date      int64  `json:"date"`       // 日志日期，格式为 YYYYMMDD。
-	Name      string `json:"name"`       // 日志文件名
-	URL       string `json:"url"`        // 日志下载链接，24 小时内下载有效。
-	StartTime int64  `json:"start_time"` // 查询起始时间，Unix 时间戳，单位：秒。
-	EndTime   int64  `json:"end_time"`   // 查询结束时间，Unix 时间戳，单位：秒。
-}
-
-// GetCdnLogsResponse 获取 CDN 日志下载链接响应
-type GetCdnLogsResponse struct {
-	util.CommonError
-	TotalCount      int           `json:"total_count"`       // 日志总条数。
-	DomesticCdnLogs []*CdnLogInfo `json:"domestic_cdn_logs"` // 日志信息列表，国内 CDN 节点的日志下载列表。
-}
-
-// AsyncMediaUploadEvent 异步媒体上传事件
-// see: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/mini-drama/mini_drama.html#_5-1-%E5%AA%92%E8%B5%84%E4%B8%8A%E4%BC%A0%E5%AE%8C%E6%88%90%E4%BA%8B%E4%BB%B6
-type AsyncMediaUploadEvent struct {
-	util.CommonError
-	MediaID       int64  `json:"media_id"`       // 媒资文件 id。
-	SourceContext string `json:"source_context"` // 来源上下文，开发者可自定义该字段内容。
-}
-
-// AsyncMediaAuditEvent 异步媒体审核事件
-// see: https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/mini-drama/mini_drama.html#_5-2-%E5%AE%A1%E6%A0%B8%E7%8A%B6%E6%80%81%E4%BA%8B%E4%BB%B6
-type AsyncMediaAuditEvent struct {
-	DramaID       int64             `json:"drama_id"`       // 剧目 id。
-	SourceContext string            `json:"source_context"` // 来源上下文，开发者可自定义该字段内容。
-	AuditDetail   *DramaAuditDetail `json:"audit_detail"`   // 审核状态。
-}

miniprogram/minidrama/minidrama.go

@@ -1,346 +0,0 @@
-/*
- *   Copyright silenceper/wechat Author(https://silenceper.com/wechat/). All Rights Reserved.
- *
- *    Licensed under the Apache License, Version 2.0 (the "License");
- *    you may not use this file except in compliance with the License.
- *    You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- *    Unless required by applicable law or agreed to in writing, software
- *    distributed under the License is distributed on an "AS IS" BASIS,
- *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *    See the License for the specific language governing permissions and
- *    limitations under the License.
- *
- *    You can obtain one at https://github.com/silenceper/wechat.
- *
- */
-
-package minidrama
-
-import (
-	"context"
-	"strconv"
-
-	"github.com/silenceper/wechat/v2/util"
-)
-
-// SingleFileUpload 单文件上传
-func (s *MiniDrama) SingleFileUpload(ctx context.Context, in *SingleFileUploadRequest) (out SingleFileUploadResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, singleFileUpload); err != nil {
-		return
-	}
-	var (
-		fields = []util.MultipartFormField{
-			{
-				IsFile:    true,
-				Fieldname: "media_data",
-				Filename:  string(in.MediaData),
-			}, {
-				IsFile:    false,
-				Fieldname: "media_name",
-				Value:     []byte(in.MediaName),
-			}, {
-				IsFile:    false,
-				Fieldname: "media_type",
-				Value:     []byte(in.MediaType),
-			},
-		}
-		response []byte
-	)
-
-	if in.CoverType != "" && in.CoverData != nil {
-		fields = append(fields, util.MultipartFormField{
-			IsFile:    false,
-			Fieldname: "cover_type",
-			Value:     []byte(in.CoverType),
-		})
-		fields = append(fields, util.MultipartFormField{
-			IsFile:    true,
-			Fieldname: "cover_data",
-			Filename:  string(in.CoverData),
-		})
-	}
-
-	if in.SourceContext != "" {
-		fields = append(fields, util.MultipartFormField{
-			IsFile:    false,
-			Fieldname: "source_context",
-			Value:     []byte(in.SourceContext),
-		})
-	}
-
-	if response, err = util.PostMultipartForm(fields, address); err != nil {
-		return
-	}
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "SingleFileUpload")
-	return
-}
-
-// PullUpload 拉取上传
-func (s *MiniDrama) PullUpload(ctx context.Context, in *PullUploadRequest) (out PullUploadResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, pullUpload); err != nil {
-		return
-	}
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "PullUpload")
-	return
-}
-
-// GetTask 查询任务状态
-func (s *MiniDrama) GetTask(ctx context.Context, in *GetTaskRequest) (out GetTaskResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getTask); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetTask")
-	return
-}
-
-// ApplyUpload 申请分片上传
-func (s *MiniDrama) ApplyUpload(ctx context.Context, in *ApplyUploadRequest) (out ApplyUploadResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, applyUpload); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "ApplyUpload")
-	return
-}
-
-// UploadPart 上传分片
-// Content-Type 需要指定为 multipart/form-data; boundary=<delimiter>，<箭头括号>表示必须替换为有效值的变量。
-func (s *MiniDrama) UploadPart(ctx context.Context, in *UploadPartRequest) (out UploadPartResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, uploadPart); err != nil {
-		return
-	}
-
-	var (
-		fields = []util.MultipartFormField{
-			{
-				IsFile:    true,
-				Fieldname: "data",
-				Filename:  string(in.Data),
-			}, {
-				IsFile:    false,
-				Fieldname: "upload_id",
-				Value:     []byte(in.UploadID),
-			}, {
-				IsFile:    false,
-				Fieldname: "part_number",
-				Value:     []byte(strconv.Itoa(in.PartNumber)),
-			}, {
-				IsFile:    false,
-				Fieldname: "resource_type",
-				Value:     []byte(strconv.Itoa(in.PartNumber)),
-			},
-		}
-		response []byte
-	)
-	if response, err = util.PostMultipartForm(fields, address); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "UploadPart")
-	return
-}
-
-// CommitUpload 确认上传
-func (s *MiniDrama) CommitUpload(ctx context.Context, in *CommitUploadRequest) (out CommitUploadResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, commitUpload); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "CommitUpload")
-	return
-}
-
-// ListMedia 获取媒体列表
-func (s *MiniDrama) ListMedia(ctx context.Context, in *ListMediaRequest) (out ListMediaResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, listMedia); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "ListMedia")
-	return
-}
-
-// GetMedia 获取媒资详细信息
-func (s *MiniDrama) GetMedia(ctx context.Context, in *GetMediaRequest) (out GetMediaResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getMedia); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetMedia")
-	return
-}
-
-// GetMediaLink 获取媒资播放链接
-func (s *MiniDrama) GetMediaLink(ctx context.Context, in *GetMediaLinkRequest) (out GetMediaLinkResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getMediaLink); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetMediaLink")
-	return
-}
-
-// DeleteMedia 删除媒体
-func (s *MiniDrama) DeleteMedia(ctx context.Context, in *DeleteMediaRequest) (out DeleteMediaResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, deleteMedia); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "DeleteMedia")
-	return
-}
-
-// AuditDrama 审核剧本
-func (s *MiniDrama) AuditDrama(ctx context.Context, in *AuditDramaRequest) (out AuditDramaResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, auditDrama); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "AuditDrama")
-	return
-}
-
-// ListDramas 获取剧目列表
-func (s *MiniDrama) ListDramas(ctx context.Context, in *ListDramasRequest) (out ListDramasResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, listDramas); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "ListDramas")
-	return
-}
-
-// GetDrama 获取剧目信息
-func (s *MiniDrama) GetDrama(ctx context.Context, in *GetDramaRequest) (out GetDramaResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getDrama); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetDrama")
-	return
-}
-
-// GetCdnUsageData 查询 CDN 用量数据
-func (s *MiniDrama) GetCdnUsageData(ctx context.Context, in *GetCdnUsageDataRequest) (out GetCdnUsageDataResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getCdnUsageData); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetCdnUsageData")
-	return
-}
-
-// GetCdnLogs 查询 CDN 日志
-func (s *MiniDrama) GetCdnLogs(ctx context.Context, in *GetCdnLogsRequest) (out GetCdnLogsResponse, err error) {
-	var address string
-	if address, err = s.requestAddress(ctx, getCdnLogs); err != nil {
-		return
-	}
-
-	var response []byte
-	if response, err = util.PostJSONContext(ctx, address, in); err != nil {
-		return
-	}
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &out, "GetCdnLogs")
-	return
-}
-
-// requestAddress 请求地址
-func (s *MiniDrama) requestAddress(_ context.Context, url string) (string, error) {
-	accessToken, err := s.ctx.GetAccessToken()
-	if err != nil {
-		return "", err
-	}
-	return url + accessToken, nil
-}

miniprogram/miniprogram.go

@@ -1,168 +1,17 @@
 package miniprogram
 
 import (
-	"github.com/silenceper/wechat/v2/credential"
-	"github.com/silenceper/wechat/v2/internal/openapi"
-	"github.com/silenceper/wechat/v2/miniprogram/analysis"
-	"github.com/silenceper/wechat/v2/miniprogram/auth"
-	"github.com/silenceper/wechat/v2/miniprogram/business"
-	"github.com/silenceper/wechat/v2/miniprogram/config"
-	"github.com/silenceper/wechat/v2/miniprogram/content"
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/miniprogram/encryptor"
-	"github.com/silenceper/wechat/v2/miniprogram/message"
-	"github.com/silenceper/wechat/v2/miniprogram/minidrama"
-	"github.com/silenceper/wechat/v2/miniprogram/order"
-	"github.com/silenceper/wechat/v2/miniprogram/privacy"
-	"github.com/silenceper/wechat/v2/miniprogram/qrcode"
-	"github.com/silenceper/wechat/v2/miniprogram/redpacketcover"
-	"github.com/silenceper/wechat/v2/miniprogram/riskcontrol"
-	"github.com/silenceper/wechat/v2/miniprogram/security"
-	"github.com/silenceper/wechat/v2/miniprogram/shortlink"
-	"github.com/silenceper/wechat/v2/miniprogram/subscribe"
-	"github.com/silenceper/wechat/v2/miniprogram/tcb"
-	"github.com/silenceper/wechat/v2/miniprogram/urllink"
-	"github.com/silenceper/wechat/v2/miniprogram/urlscheme"
-	"github.com/silenceper/wechat/v2/miniprogram/virtualpayment"
-	"github.com/silenceper/wechat/v2/miniprogram/werun"
+	"github.com/silenceper/wechat/context"
 )
 
-// MiniProgram 微信小程序相关 API
+// MiniProgram struct extends context
 type MiniProgram struct {
-	ctx *context.Context
+	*context.Context
 }
 
-// NewMiniProgram 实例化小程序 API
-func NewMiniProgram(cfg *config.Config) *MiniProgram {
-	defaultAkHandle := credential.NewDefaultAccessToken(cfg.AppID, cfg.AppSecret, credential.CacheKeyMiniProgramPrefix, cfg.Cache)
-	ctx := &context.Context{
-		Config:            cfg,
-		AccessTokenHandle: defaultAkHandle,
-	}
-	return &MiniProgram{ctx}
-}
-
-// SetAccessTokenHandle 自定义 access_token 获取方式
-func (miniProgram *MiniProgram) SetAccessTokenHandle(accessTokenHandle credential.AccessTokenHandle) {
-	miniProgram.ctx.AccessTokenHandle = accessTokenHandle
-}
-
-// GetContext get Context
-func (miniProgram *MiniProgram) GetContext() *context.Context {
-	return miniProgram.ctx
-}
-
-// GetEncryptor  小程序加解密
-func (miniProgram *MiniProgram) GetEncryptor() *encryptor.Encryptor {
-	return encryptor.NewEncryptor(miniProgram.ctx)
-}
-
-// GetAuth 登录/用户信息相关接口
-func (miniProgram *MiniProgram) GetAuth() *auth.Auth {
-	return auth.NewAuth(miniProgram.ctx)
-}
-
-// GetAnalysis 数据分析
-func (miniProgram *MiniProgram) GetAnalysis() *analysis.Analysis {
-	return analysis.NewAnalysis(miniProgram.ctx)
-}
-
-// GetBusiness 业务接口
-func (miniProgram *MiniProgram) GetBusiness() *business.Business {
-	return business.NewBusiness(miniProgram.ctx)
-}
-
-// GetPrivacy 小程序隐私协议相关 API
-func (miniProgram *MiniProgram) GetPrivacy() *privacy.Privacy {
-	return privacy.NewPrivacy(miniProgram.ctx)
-}
-
-// GetQRCode 小程序码相关 API
-func (miniProgram *MiniProgram) GetQRCode() *qrcode.QRCode {
-	return qrcode.NewQRCode(miniProgram.ctx)
-}
-
-// GetTcb 小程序云开发 API
-func (miniProgram *MiniProgram) GetTcb() *tcb.Tcb {
-	return tcb.NewTcb(miniProgram.ctx)
-}
-
-// GetSubscribe 小程序订阅消息
-func (miniProgram *MiniProgram) GetSubscribe() *subscribe.Subscribe {
-	return subscribe.NewSubscribe(miniProgram.ctx)
-}
-
-// GetCustomerMessage 客服消息接口
-func (miniProgram *MiniProgram) GetCustomerMessage() *message.Manager {
-	return message.NewCustomerMessageManager(miniProgram.ctx)
-}
-
-// GetWeRun 微信运动接口
-func (miniProgram *MiniProgram) GetWeRun() *werun.WeRun {
-	return werun.NewWeRun(miniProgram.ctx)
-}
-
-// GetContentSecurity 内容安全接口
-func (miniProgram *MiniProgram) GetContentSecurity() *content.Content {
-	return content.NewContent(miniProgram.ctx)
-}
-
-// GetURLLink 小程序 URL Link 接口
-func (miniProgram *MiniProgram) GetURLLink() *urllink.URLLink {
-	return urllink.NewURLLink(miniProgram.ctx)
-}
-
-// GetRiskControl 安全风控接口
-func (miniProgram *MiniProgram) GetRiskControl() *riskcontrol.RiskControl {
-	return riskcontrol.NewRiskControl(miniProgram.ctx)
-}
-
-// GetSecurity 内容安全接口
-func (miniProgram *MiniProgram) GetSecurity() *security.Security {
-	return security.NewSecurity(miniProgram.ctx)
-}
-
-// GetShortLink 小程序短链接口
-func (miniProgram *MiniProgram) GetShortLink() *shortlink.ShortLink {
-	return shortlink.NewShortLink(miniProgram.ctx)
-}
-
-// GetSURLScheme 小程序 URL Scheme 接口
-func (miniProgram *MiniProgram) GetSURLScheme() *urlscheme.URLScheme {
-	return urlscheme.NewURLScheme(miniProgram.ctx)
-}
-
-// GetOpenAPI openApi 管理接口
-func (miniProgram *MiniProgram) GetOpenAPI() *openapi.OpenAPI {
-	return openapi.NewOpenAPI(miniProgram.ctx)
-}
-
-// GetVirtualPayment 小程序虚拟支付
-func (miniProgram *MiniProgram) GetVirtualPayment() *virtualpayment.VirtualPayment {
-	return virtualpayment.NewVirtualPayment(miniProgram.ctx)
-}
-
-// GetMessageReceiver 获取消息推送接收器
-func (miniProgram *MiniProgram) GetMessageReceiver() *message.PushReceiver {
-	return message.NewPushReceiver(miniProgram.ctx)
-}
-
-// GetShipping 小程序发货信息管理服务
-func (miniProgram *MiniProgram) GetShipping() *order.Shipping {
-	return order.NewShipping(miniProgram.ctx)
-}
-
-// GetMiniDrama 小程序娱乐微短剧
-func (miniProgram *MiniProgram) GetMiniDrama() *minidrama.MiniDrama {
-	return minidrama.NewMiniDrama(miniProgram.ctx)
-}
-
-// GetRedPacketCover 小程序微信红包封面 API
-func (miniProgram *MiniProgram) GetRedPacketCover() *redpacketcover.RedPacketCover {
-	return redpacketcover.NewRedPacketCover(miniProgram.ctx)
-}
-
-// GetUpdatableMessage 小程序动态消息
-func (miniProgram *MiniProgram) GetUpdatableMessage() *message.UpdatableMessage {
-	return message.NewUpdatableMessage(miniProgram.ctx)
+// NewMiniProgram 实例化小程序接口
+func NewMiniProgram(context *context.Context) *MiniProgram {
+	miniProgram := new(MiniProgram)
+	miniProgram.Context = context
+	return miniProgram
 }

miniprogram/order/shipping.go

@@ -1,269 +0,0 @@
-package order
-
-import (
-	"fmt"
-	"time"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	// 发货信息录入
-	uploadShippingInfoURL = "https://api.weixin.qq.com/wxa/sec/order/upload_shipping_info?access_token=%s"
-
-	// 查询订单发货状态
-	getShippingOrderURL = "https://api.weixin.qq.com/wxa/sec/order/get_order?access_token=%s"
-
-	// 查询订单列表
-	getShippingOrderListURL = "https://api.weixin.qq.com/wxa/sec/order/get_order_list?access_token=%s"
-
-	// 确认收货提醒接口
-	notifyConfirmReceiveURL = "https://api.weixin.qq.com/wxa/sec/order/notify_confirm_receive?access_token=%s"
-)
-
-// Shipping 发货信息管理
-type Shipping struct {
-	*context.Context
-}
-
-// NewShipping init
-func NewShipping(ctx *context.Context) *Shipping {
-	return &Shipping{ctx}
-}
-
-// UploadShippingInfo 发货信息录入
-// see https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/order-shipping/order-shipping.html
-func (shipping *Shipping) UploadShippingInfo(in *UploadShippingInfoRequest) (err error) {
-	accessToken, err := shipping.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(uploadShippingInfoURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	return util.DecodeWithCommonError(response, "UploadShippingInfo")
-}
-
-// GetShippingOrder 查询订单发货状态
-func (shipping *Shipping) GetShippingOrder(in *GetShippingOrderRequest) (res ShippingOrderResponse, err error) {
-	accessToken, err := shipping.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(getShippingOrderURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	err = util.DecodeWithError(response, &res, "GetShippingOrder")
-	return
-}
-
-// GetShippingOrderList 查询订单列表
-func (shipping *Shipping) GetShippingOrderList(in *GetShippingOrderListRequest) (res GetShippingOrderListResponse, err error) {
-	accessToken, err := shipping.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(getShippingOrderListURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	err = util.DecodeWithError(response, &res, "GetShippingOrderList")
-	return
-}
-
-// NotifyConfirmReceive 确认收货提醒接口
-func (shipping *Shipping) NotifyConfirmReceive(in *NotifyConfirmReceiveRequest) (err error) {
-	accessToken, err := shipping.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(notifyConfirmReceiveURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	return util.DecodeWithCommonError(response, "NotifyConfirmReceive")
-}
-
-// UploadShippingInfoRequest 发货信息录入请求参数
-type UploadShippingInfoRequest struct {
-	OrderKey       *ShippingOrderKey `json:"order_key"`        // 订单，需要上传物流信息的订单
-	LogisticsType  LogisticsType     `json:"logistics_type"`   // 物流模式
-	DeliveryMode   DeliveryMode      `json:"delivery_mode"`    // 发货模式
-	IsAllDelivered bool              `json:"is_all_delivered"` // 分拆发货模式时必填，用于标识分拆发货模式下是否已全部发货完成
-	ShippingList   []*ShippingInfo   `json:"shipping_list"`    // 物流信息列表，发货物流单列表，支持统一发货（单个物流单）和分拆发货（多个物流单）两种模式
-	UploadTime     *time.Time        `json:"upload_time"`      // 上传时间，用于标识请求的先后顺序
-	Payer          *ShippingPayer    `json:"payer"`            // 支付人信息
-}
-
-// ShippingOrderKey 订单
-type ShippingOrderKey struct {
-	OrderNumberType NumberType `json:"order_number_type"` // 订单单号类型，用于确认需要上传详情的订单。枚举值1，使用下单商户号和商户侧单号；枚举值2，使用微信支付单号。
-	TransactionID   string     `json:"transaction_id"`    // 原支付交易对应的微信订单号
-	Mchid           string     `json:"mchid"`             // 支付下单商户的商户号，由微信支付生成并下发
-	OutTradeNo      string     `json:"out_trade_no"`      // 商户系统内部订单号，只能是数字、大小写字母`_-*`且在同一个商户号下唯一
-}
-
-// ShippingPayer 支付者信息
-type ShippingPayer struct {
-	Openid string `json:"openid"` // 用户标识，用户在小程序appid下的唯一标识
-}
-
-// ShippingInfo 物流信息
-type ShippingInfo struct {
-	TrackingNo     string          `json:"tracking_no"`     // 物流单号，物流快递发货时必填
-	ExpressCompany string          `json:"express_company"` // 物流公司编码，快递公司ID，物流快递发货时必填；参见「查询物流公司编码列表」
-	ItemDesc       string          `json:"item_desc"`       // 商品信息，例如：微信红包抱枕*1个，限120个字以内
-	Contact        ShippingContact `json:"contact"`         // 联系方式，当发货的物流公司为顺丰时，联系方式为必填，收件人或寄件人联系方式二选一
-}
-
-// ShippingContact 联系方式
-type ShippingContact struct {
-	ConsignorContact string `json:"consignor_contact"` // 寄件人联系方式，寄件人联系方式，采用掩码传输，最后4位数字不能打掩码
-	ReceiverContact  string `json:"receiver_contact"`  // 收件人联系方式，收件人联系方式，采用掩码传输，最后4位数字不能打掩码
-}
-
-// DeliveryMode 发货模式
-type DeliveryMode uint8
-
-const (
-	// DeliveryModeUnifiedDelivery 统一发货
-	DeliveryModeUnifiedDelivery DeliveryMode = 1
-	// DeliveryModeSplitDelivery 分拆发货
-	DeliveryModeSplitDelivery DeliveryMode = 2
-)
-
-// LogisticsType 物流模式
-type LogisticsType uint8
-
-const (
-	// LogisticsTypeExpress 实体物流配送采用快递公司进行实体物流配送形式
-	LogisticsTypeExpress LogisticsType = 1
-	// LogisticsTypeSameCity 同城配送
-	LogisticsTypeSameCity LogisticsType = 2
-	// LogisticsTypeVirtual 虚拟商品，虚拟商品，例如话费充值，点卡等，无实体配送形式
-	LogisticsTypeVirtual LogisticsType = 3
-	// LogisticsTypeSelfPickup 用户自提
-	LogisticsTypeSelfPickup LogisticsType = 4
-)
-
-// NumberType 订单单号类型
-type NumberType uint8
-
-const (
-	// NumberTypeOutTradeNo 使用下单商户号和商户侧单号
-	NumberTypeOutTradeNo NumberType = 1
-	// NumberTypeTransactionID 使用微信支付单号
-	NumberTypeTransactionID NumberType = 2
-)
-
-// GetShippingOrderRequest 查询订单发货状态参数
-type GetShippingOrderRequest struct {
-	TransactionID   string `json:"transaction_id"`    // 原支付交易对应的微信订单号
-	MerchantID      string `json:"merchant_id"`       // 支付下单商户的商户号，由微信支付生成并下发
-	SubMerchantID   string `json:"sub_merchant_id"`   //二级商户号
-	MerchantTradeNo string `json:"merchant_trade_no"` //商户系统内部订单号，只能是数字、大小写字母`_-*`且在同一个商户号下唯一。
-}
-
-// ShippingItem 物流信息
-type ShippingItem struct {
-	TrackingNo     string `json:"tracking_no"`     // 物流单号，示例值: "323244567777
-	ExpressCompany string `json:"express_company"` // 物流公司编码，快递公司ID，物流快递发货时必填；参见「查询物流公司编码列表」
-	UploadTime     int64  `json:"upload_time"`     // 上传物流信息时间，时间戳形式
-}
-
-// ShippingDetail 发货信息
-type ShippingDetail struct {
-	DeliveryMode        DeliveryMode    `json:"delivery_mode"`         // 发货模式
-	LogisticsType       LogisticsType   `json:"logistics_type"`        // 物流模式
-	FinishShipping      bool            `json:"finish_shipping"`       // 是否已全部发货
-	FinishShippingCount int             `json:"finish_shipping_count"` // 已完成全部发货的次数
-	GoodsDesc           string          `json:"goods_desc"`            // 在小程序后台发货信息录入页录入的商品描述
-	ShippingList        []*ShippingItem `json:"shipping_list"`         // 物流信息列表
-}
-
-// ShippingOrder 订单发货状态
-type ShippingOrder struct {
-	TransactionID   string          `json:"transaction_id"`    // 原支付交易对应的微信订单号
-	MerchantTradeNo string          `json:"merchant_trade_no"` // 商户系统内部订单号，只能是数字、大小写字母`_-*`且在同一个商户号下唯一
-	MerchantID      string          `json:"merchant_id"`       // 支付下单商户的商户号，由微信支付生成并下发
-	SubMerchantID   string          `json:"sub_merchant_id"`   // 二级商户号
-	Description     string          `json:"description"`       // 以分号连接的该支付单的所有商品描述，当超过120字时自动截断并以 “...” 结尾
-	PaidAmount      int64           `json:"paid_amount"`       // 支付单实际支付金额，整型，单位：分钱
-	Openid          string          `json:"openid"`            // 支付者openid
-	TradeCreateTime int64           `json:"trade_create_time"` // 交易创建时间，时间戳形式
-	PayTime         int64           `json:"pay_time"`          // 支付时间，时间戳形式
-	InComplaint     bool            `json:"in_complaint"`      // 是否处在交易纠纷中
-	OrderState      State           `json:"order_state"`       // 订单状态枚举：(1) 待发货；(2) 已发货；(3) 确认收货；(4) 交易完成；(5) 已退款
-	Shipping        *ShippingDetail `json:"shipping"`          // 订单发货信息
-}
-
-// ShippingOrderResponse 查询订单发货状态返回参数
-type ShippingOrderResponse struct {
-	util.CommonError
-	Order ShippingOrder `json:"order"` // 订单发货信息
-}
-
-// State 订单状态
-type State uint8
-
-const (
-	// StateWaitShipment 待发货
-	StateWaitShipment State = 1
-	// StateShipped 已发货
-	StateShipped State = 2
-	// StateConfirm 确认收货
-	StateConfirm State = 3
-	// StateComplete 交易完成
-	StateComplete State = 4
-	// StateRefund 已退款
-	StateRefund State = 5
-)
-
-// GetShippingOrderListRequest 查询订单列表请求参数
-type GetShippingOrderListRequest struct {
-	PayTimeRange *TimeRange `json:"pay_time_range"`        // 支付时间范围
-	OrderState   State      `json:"order_state,omitempty"` // 订单状态
-	Openid       string     `json:"openid,omitempty"`      // 支付者openid
-	LastIndex    string     `json:"last_index,omitempty"`  // 	翻页时使用，获取第一页时不用传入，如果查询结果中 has_more 字段为 true，则传入该次查询结果中返回的 last_index 字段可获取下一页
-	PageSize     int64      `json:"page_size"`             // 每页数量，最多50条
-}
-
-// TimeRange 时间范围
-type TimeRange struct {
-	BeginTime int64 `json:"begin_time,omitempty"` // 查询开始时间，时间戳形式
-	EndTime   int64 `json:"end_time,omitempty"`   // 查询结束时间，时间戳形式
-}
-
-// GetShippingOrderListResponse 查询订单列表返回参数
-type GetShippingOrderListResponse struct {
-	util.CommonError
-	OrderList []*ShippingOrder `json:"order_list"`
-	LastIndex string           `json:"last_index"`
-	HasMore   bool             `json:"has_more"`
-}
-
-// NotifyConfirmReceiveRequest 确认收货提醒接口请求参数
-type NotifyConfirmReceiveRequest struct {
-	TransactionID   string `json:"transaction_id"`    // 原支付交易对应的微信订单号
-	MerchantID      string `json:"merchant_id"`       // 支付下单商户的商户号，由微信支付生成并下发
-	SubMerchantID   string `json:"sub_merchant_id"`   // 二级商户号
-	MerchantTradeNo string `json:"merchant_trade_no"` // 商户系统内部订单号，只能是数字、大小写字母`_-*`且在同一个商户号下唯一
-	ReceivedTime    int64  `json:"received_time"`     // 收货时间，时间戳形式
-}

miniprogram/privacy/privacy.go

@@ -1,157 +0,0 @@
-package privacy
-
-import (
-	"errors"
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-// Privacy 小程序授权隐私设置
-type Privacy struct {
-	*context.Context
-}
-
-// NewPrivacy 实例化小程序隐私接口
-// 文档地址 https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/privacy_config/set_privacy_setting.html
-func NewPrivacy(context *context.Context) *Privacy {
-	if context == nil {
-		panic("NewPrivacy got a nil context")
-	}
-	return &Privacy{
-		context,
-	}
-}
-
-// OwnerSetting 收集方（开发者）信息配置
-type OwnerSetting struct {
-	ContactEmail         string `json:"contact_email"`
-	ContactPhone         string `json:"contact_phone"`
-	ContactQQ            string `json:"contact_qq"`
-	ContactWeixin        string `json:"contact_weixin"`
-	ExtFileMediaID       string `json:"ext_file_media_id"`
-	NoticeMethod         string `json:"notice_method"`
-	StoreExpireTimestamp string `json:"store_expire_timestamp"`
-}
-
-// SettingItem 收集权限的配置
-type SettingItem struct {
-	PrivacyKey  string `json:"privacy_key"`
-	PrivacyText string `json:"privacy_text"`
-}
-
-// SetPrivacySettingRequest 设置权限的请求参数
-type SetPrivacySettingRequest struct {
-	PrivacyVer   int           `json:"privacy_ver"`
-	OwnerSetting OwnerSetting  `json:"owner_setting"`
-	SettingList  []SettingItem `json:"setting_list"`
-}
-
-const (
-	setPrivacySettingURL    = "https://api.weixin.qq.com/cgi-bin/component/setprivacysetting"
-	getPrivacySettingURL    = "https://api.weixin.qq.com/cgi-bin/component/getprivacysetting"
-	uploadPrivacyExtFileURL = "https://api.weixin.qq.com/cgi-bin/component/uploadprivacyextfile"
-
-	// PrivacyV1 用户隐私保护指引的版本，1表示现网版本。
-	PrivacyV1 = 1
-	// PrivacyV2 2表示开发版。默认是2开发版。
-	PrivacyV2 = 2
-)
-
-// GetPrivacySettingResponse 获取权限配置的响应结果
-type GetPrivacySettingResponse struct {
-	util.CommonError
-	CodeExist    int                   `json:"code_exist"`
-	PrivacyList  []string              `json:"privacy_list"`
-	SettingList  []SettingResponseItem `json:"setting_list"`
-	UpdateTime   int64                 `json:"update_time"`
-	OwnerSetting OwnerSetting          `json:"owner_setting"`
-	PrivacyDesc  DescList              `json:"privacy_desc"`
-}
-
-// SettingResponseItem 获取权限设置的响应明细
-type SettingResponseItem struct {
-	PrivacyKey   string `json:"privacy_key"`
-	PrivacyText  string `json:"privacy_text"`
-	PrivacyLabel string `json:"privacy_label"`
-}
-
-// DescList 权限列表(保持与官方一致)
-type DescList struct {
-	PrivacyDescList []Desc `json:"privacy_desc_list"`
-}
-
-// Desc 权限列表明细(保持与官方一致)
-type Desc struct {
-	PrivacyDesc string `json:"privacy_desc"`
-	PrivacyKey  string `json:"privacy_key"`
-}
-
-// GetPrivacySetting 获取小程序权限配置
-func (s *Privacy) GetPrivacySetting(privacyVer int) (GetPrivacySettingResponse, error) {
-	accessToken, err := s.GetAccessToken()
-	if err != nil {
-		return GetPrivacySettingResponse{}, err
-	}
-
-	response, err := util.PostJSON(fmt.Sprintf("%s?access_token=%s", getPrivacySettingURL, accessToken), map[string]int{
-		"privacy_ver": privacyVer,
-	})
-	if err != nil {
-		return GetPrivacySettingResponse{}, err
-	}
-	// 返回错误信息
-	var result GetPrivacySettingResponse
-	err = util.DecodeWithError(response, &result, "getprivacysetting")
-	return result, err
-}
-
-// SetPrivacySetting 更新小程序权限配置
-func (s *Privacy) SetPrivacySetting(privacyVer int, ownerSetting OwnerSetting, settingList []SettingItem) error {
-	if privacyVer == PrivacyV1 && len(settingList) > 0 {
-		return errors.New("当privacy_ver传2或者不传时，setting_list是必填；当privacy_ver传1时，该参数不可传")
-	}
-	accessToken, err := s.GetAccessToken()
-	if err != nil {
-		return err
-	}
-
-	response, err := util.PostJSON(fmt.Sprintf("%s?access_token=%s", setPrivacySettingURL, accessToken), SetPrivacySettingRequest{
-		PrivacyVer:   privacyVer,
-		OwnerSetting: ownerSetting,
-		SettingList:  settingList,
-	})
-	if err != nil {
-		return err
-	}
-
-	// 返回错误信息
-	return util.DecodeWithCommonError(response, "setprivacysetting")
-}
-
-// UploadPrivacyExtFileResponse 上传权限定义模板响应参数
-type UploadPrivacyExtFileResponse struct {
-	util.CommonError
-	ExtFileMediaID string `json:"ext_file_media_id"`
-}
-
-// UploadPrivacyExtFile 上传权限定义模板
-func (s *Privacy) UploadPrivacyExtFile(fileData []byte) (UploadPrivacyExtFileResponse, error) {
-	accessToken, err := s.GetAccessToken()
-	if err != nil {
-		return UploadPrivacyExtFileResponse{}, err
-	}
-
-	response, err := util.PostJSON(fmt.Sprintf("%s?access_token=%s", uploadPrivacyExtFileURL, accessToken), map[string][]byte{
-		"file": fileData,
-	})
-	if err != nil {
-		return UploadPrivacyExtFileResponse{}, err
-	}
-
-	// 返回错误信息
-	var result UploadPrivacyExtFileResponse
-	err = util.DecodeWithError(response, &result, "setprivacysetting")
-	return result, err
-}

miniprogram/qrcode.go

@@ -1,12 +1,11 @@
-package qrcode
+package miniprogram
 
 import (
 	"encoding/json"
 	"fmt"
 	"strings"
 
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
+	"github.com/silenceper/wechat/util"
 )
 
 const (
@@ -15,16 +14,22 @@ const (
 	getWXACodeUnlimitURL = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=%s"
 )
 
-// QRCode struct
-type QRCode struct {
-	*context.Context
-}
-
-// NewQRCode 实例
-func NewQRCode(context *context.Context) *QRCode {
-	qrCode := new(QRCode)
-	qrCode.Context = context
-	return qrCode
+// QRCoder 小程序码参数
+type QRCoder struct {
+	// page 必须是已经发布的小程序存在的页面,根路径前不要填加 /,不能携带参数（参数请放在scene字段里），如果不填写这个字段，默认跳主页面
+	Page string `json:"page,omitempty"`
+	// path 扫码进入的小程序页面路径
+	Path string `json:"path,omitempty"`
+	// width 图片宽度
+	Width int `json:"width,omitempty"`
+	// scene 最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式）
+	Scene string `json:"scene,omitempty"`
+	// autoColor 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调
+	AutoColor bool `json:"auto_color,omitempty"`
+	// lineColor AutoColor 为 false 时生效，使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"},十进制表示
+	LineColor Color `json:"line_color,omitempty"`
+	// isHyaline 是否需要透明底色
+	IsHyaline bool `json:"is_hyaline,omitempty"`
 }
 
 // Color QRCode color
@@ -34,34 +39,10 @@ type Color struct {
 	B string `json:"b"`
 }
 
-// QRCoder 小程序码参数
-type QRCoder struct {
-	// page 必须是已经发布的小程序存在的页面,根路径前不要填加 /,不能携带参数（参数请放在scene字段里），如果不填写这个字段，默认跳主页面
-	Page string `json:"page,omitempty"`
-	// path 扫码进入的小程序页面路径
-	Path string `json:"path,omitempty"`
-	// checkPath 检查page 是否存在，为 true 时 page 必须是已经发布的小程序存在的页面（否则报错）；为 false 时允许小程序未发布或者 page 不存在， 但page 有数量上限（60000个）请勿滥用，默认true
-	CheckPath *bool `json:"check_path,omitempty"`
-	// width 图片宽度
-	Width int `json:"width,omitempty"`
-	// scene 最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式）
-	Scene string `json:"scene,omitempty"`
-	// autoColor 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调，默认false
-	AutoColor bool `json:"auto_color,omitempty"`
-	// lineColor AutoColor 为 false 时生效，使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"},十进制表示
-	LineColor *Color `json:"line_color,omitempty"`
-	// isHyaline 是否需要透明底色，默认false
-	IsHyaline bool `json:"is_hyaline,omitempty"`
-	// envVersion 要打开的小程序版本。正式版为 "release"，体验版为 "trial"，开发版为 "develop"
-	EnvVersion string `json:"env_version,omitempty"`
-	// ShowSplashAd 控制通过该小程序码进入小程序是否展示封面广告1、默认为true，展示封面广告2、传入为false时，不展示封面广告
-	ShowSplashAd bool `json:"show_splash_ad,omitempty"`
-}
-
 // fetchCode 请求并返回二维码二进制数据
-func (qrCode *QRCode) fetchCode(urlStr string, body interface{}) (response []byte, err error) {
+func (wxa *MiniProgram) fetchCode(urlStr string, body interface{}) (response []byte, err error) {
 	var accessToken string
-	accessToken, err = qrCode.GetAccessToken()
+	accessToken, err = wxa.GetAccessToken()
 	if err != nil {
 		return
 	}
@@ -80,29 +61,31 @@ func (qrCode *QRCode) fetchCode(urlStr string, body interface{}) (response []byt
 			err = fmt.Errorf("fetchCode error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
 			return nil, err
 		}
-	}
-	if contentType == "image/jpeg" {
+	} else if contentType == "image/jpeg" {
 		// 返回文件
 		return response, nil
+	} else {
+		err = fmt.Errorf("fetchCode error : unknown response content type - %v", contentType)
+		return nil, err
 	}
-	err = fmt.Errorf("fetchCode error : unknown response content type - %v", contentType)
-	return nil, err
+
+	return
 }
 
 // CreateWXAQRCode 获取小程序二维码，适用于需要的码数量较少的业务场景
 // 文档地址： https://developers.weixin.qq.com/miniprogram/dev/api/createWXAQRCode.html
-func (qrCode *QRCode) CreateWXAQRCode(coderParams QRCoder) (response []byte, err error) {
-	return qrCode.fetchCode(createWXAQRCodeURL, coderParams)
+func (wxa *MiniProgram) CreateWXAQRCode(coderParams QRCoder) (response []byte, err error) {
+	return wxa.fetchCode(createWXAQRCodeURL, coderParams)
 }
 
 // GetWXACode 获取小程序码，适用于需要的码数量较少的业务场景
 // 文档地址： https://developers.weixin.qq.com/miniprogram/dev/api/getWXACode.html
-func (qrCode *QRCode) GetWXACode(coderParams QRCoder) (response []byte, err error) {
-	return qrCode.fetchCode(getWXACodeURL, coderParams)
+func (wxa *MiniProgram) GetWXACode(coderParams QRCoder) (response []byte, err error) {
+	return wxa.fetchCode(getWXACodeURL, coderParams)
 }
 
 // GetWXACodeUnlimit 获取小程序码，适用于需要的码数量极多的业务场景
 // 文档地址： https://developers.weixin.qq.com/miniprogram/dev/api/getWXACodeUnlimit.html
-func (qrCode *QRCode) GetWXACodeUnlimit(coderParams QRCoder) (response []byte, err error) {
-	return qrCode.fetchCode(getWXACodeUnlimitURL, coderParams)
+func (wxa *MiniProgram) GetWXACodeUnlimit(coderParams QRCoder) (response []byte, err error) {
+	return wxa.fetchCode(getWXACodeUnlimitURL, coderParams)
 }

miniprogram/redpacketcover/redpacketcover.go

@@ -1,59 +0,0 @@
-package redpacketcover
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	getRedPacketCoverURL = "https://api.weixin.qq.com/redpacketcover/wxapp/cover_url/get_by_token?access_token=%s"
-)
-
-// RedPacketCover struct
-type RedPacketCover struct {
-	*context.Context
-}
-
-// NewRedPacketCover 实例
-func NewRedPacketCover(context *context.Context) *RedPacketCover {
-	redPacketCover := new(RedPacketCover)
-	redPacketCover.Context = context
-	return redPacketCover
-}
-
-// GetRedPacketCoverRequest 获取微信红包封面参数
-type GetRedPacketCoverRequest struct {
-	// openid 可领取用户的openid
-	OpenID string `json:"openid"`
-	// ctoken 在红包封面平台获取发放ctoken（需要指定可以发放的appid）
-	CToken string `json:"ctoken"`
-}
-
-// GetRedPacketCoverResp 获取微信红包封面
-type GetRedPacketCoverResp struct {
-	util.CommonError
-	Data struct {
-		URL string `json:"url"`
-	} `json:"data"` // 唯一请求标识
-}
-
-// GetRedPacketCoverURL 获得指定用户可以领取的红包封面链接。获取参数ctoken参考微信红包封面开放平台
-// 文档地址： https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/red-packet-cover/getRedPacketCoverUrl.html
-func (cover *RedPacketCover) GetRedPacketCoverURL(coderParams GetRedPacketCoverRequest) (res GetRedPacketCoverResp, err error) {
-	accessToken, err := cover.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(getRedPacketCoverURL, accessToken)
-	response, err := util.PostJSON(uri, coderParams)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &res, "GetRedPacketCoverURL")
-	return
-}

miniprogram/riskcontrol/riskcontrol.go

@@ -1,60 +0,0 @@
-package riskcontrol
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	getUserRiskRankURL = "https://api.weixin.qq.com/wxa/getuserriskrank?access_token=%s"
-)
-
-// RiskControl 安全风控
-type RiskControl struct {
-	*context.Context
-}
-
-// NewRiskControl init
-func NewRiskControl(ctx *context.Context) *RiskControl {
-	return &RiskControl{ctx}
-}
-
-// UserRiskRankRequest 获取用户安全等级请求
-type UserRiskRankRequest struct {
-	AppID    string `json:"appid"`     // 小程序 app id
-	OpenID   string `json:"openid"`    // 用户的 openid
-	Scene    uint8  `json:"scene"`     // 场景值，0:注册，1:营销作弊
-	ClientIP string `json:"client_ip"` // 用户访问源ip
-
-	Mobile       string `json:"mobile_no"`     // 用户手机号
-	Email        string `json:"email_address"` // 用户邮箱地址
-	ExtendedInfo string `json:"extended_info"` // 额外补充信息
-	IsTest       bool   `json:"is_test"`       // false：正式调用，true：测试调用
-}
-
-// UserRiskRank 用户安全等级
-type UserRiskRank struct {
-	util.CommonError
-	UnionID  int64 `json:"union_id"`  // 唯一请求标识
-	RiskRank uint8 `json:"risk_rank"` // 用户风险等级
-}
-
-// GetUserRiskRank 根据提交的用户信息数据获取用户的安全等级 risk_rank，无需用户授权。
-func (riskControl *RiskControl) GetUserRiskRank(in *UserRiskRankRequest) (res UserRiskRank, err error) {
-	accessToken, err := riskControl.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(getUserRiskRankURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &res, "GetUserRiskRank")
-	return
-}

miniprogram/security/security.go

@@ -1,246 +0,0 @@
-package security
-
-import (
-	"fmt"
-	"strconv"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	mediaCheckAsyncURL = "https://api.weixin.qq.com/wxa/media_check_async?access_token=%s"
-	imageCheckURL      = "https://api.weixin.qq.com/wxa/img_sec_check?access_token=%s"
-	msgCheckURL        = "https://api.weixin.qq.com/wxa/msg_sec_check?access_token=%s"
-)
-
-// Security 内容安全
-type Security struct {
-	*context.Context
-}
-
-// NewSecurity init
-func NewSecurity(ctx *context.Context) *Security {
-	return &Security{ctx}
-}
-
-// MediaCheckAsyncV1Request 图片/音频异步校验请求参数
-type MediaCheckAsyncV1Request struct {
-	MediaURL  string `json:"media_url"`  // 要检测的图片或音频的url，支持图片格式包括jpg, jepg, png, bmp, gif（取首帧），支持的音频格式包括mp3, aac, ac3, wma, flac, vorbis, opus, wav
-	MediaType uint8  `json:"media_type"` // 1:音频;2:图片
-}
-
-// MediaCheckAsyncV1 异步校验图片/音频是否含有违法违规内容
-// Deprecated
-// 在2021年9月1日停止更新，请尽快更新至 2.0 接口。建议使用 MediaCheckAsync
-func (security *Security) MediaCheckAsyncV1(in *MediaCheckAsyncV1Request) (traceID string, err error) {
-	accessToken, err := security.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(mediaCheckAsyncURL, accessToken)
-	response, err := util.PostJSON(uri, in)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	var res struct {
-		util.CommonError
-		TraceID string `json:"trace_id"`
-	}
-	err = util.DecodeWithError(response, &res, "MediaCheckAsyncV1")
-	return res.TraceID, err
-}
-
-// MediaCheckAsyncRequest 图片/音频异步校验请求参数
-type MediaCheckAsyncRequest struct {
-	MediaURL  string `json:"media_url"`  // 要检测的图片或音频的url，支持图片格式包括jpg, jepg, png, bmp, gif（取首帧），支持的音频格式包括mp3, aac, ac3, wma, flac, vorbis, opus, wav
-	MediaType uint8  `json:"media_type"` // 1:音频;2:图片
-	OpenID    string `json:"openid"`     // 用户的openid（用户需在近两小时访问过小程序）
-	Scene     uint8  `json:"scene"`      // 场景枚举值（1 资料；2 评论；3 论坛；4 社交日志）
-}
-
-// MediaCheckAsync 异步校验图片/音频是否含有违法违规内容
-func (security *Security) MediaCheckAsync(in *MediaCheckAsyncRequest) (traceID string, err error) {
-	accessToken, err := security.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	var req struct {
-		MediaCheckAsyncRequest
-		Version uint `json:"version"` // 接口版本号，2.0版本为固定值2
-	}
-	req.MediaCheckAsyncRequest = *in
-	req.Version = 2
-
-	uri := fmt.Sprintf(mediaCheckAsyncURL, accessToken)
-	response, err := util.PostJSON(uri, req)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	var res struct {
-		util.CommonError
-		TraceID string `json:"trace_id"`
-	}
-	err = util.DecodeWithError(response, &res, "MediaCheckAsync")
-	return res.TraceID, err
-}
-
-// ImageCheckV1 校验一张图片是否含有违法违规内容（同步）
-// https://developers.weixin.qq.com/miniprogram/dev/framework/security.imgSecCheck.html
-// Deprecated
-// 在2021年9月1日停止更新。建议使用 MediaCheckAsync
-func (security *Security) ImageCheckV1(filename string) (err error) {
-	accessToken, err := security.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	uri := fmt.Sprintf(imageCheckURL, accessToken)
-	response, err := util.PostFile("media", filename, uri)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	return util.DecodeWithCommonError(response, "ImageCheckV1")
-}
-
-// CheckSuggest 检查建议
-type CheckSuggest string
-
-const (
-	// CheckSuggestRisky 违规风险建议
-	CheckSuggestRisky CheckSuggest = "risky"
-	// CheckSuggestPass 安全
-	CheckSuggestPass CheckSuggest = "pass"
-	// CheckSuggestReview 需要审查
-	CheckSuggestReview CheckSuggest = "review"
-)
-
-// MsgScene 文本场景
-type MsgScene uint8
-
-const (
-	// MsgSceneMaterial 资料文件检查场景
-	MsgSceneMaterial MsgScene = iota + 1
-	// MsgSceneComment 评论
-	MsgSceneComment
-	// MsgSceneForum 论坛
-	MsgSceneForum
-	// MsgSceneSocialLog 社交日志
-	MsgSceneSocialLog
-)
-
-// CheckLabel 检查命中标签
-type CheckLabel int
-
-func (cl CheckLabel) String() string {
-	switch cl {
-	case 100:
-		return "正常"
-	case 10001:
-		return "广告"
-	case 20001:
-		return "时政"
-	case 20002:
-		return "色情"
-	case 20003:
-		return "辱骂"
-	case 20006:
-		return "违法犯罪"
-	case 20008:
-		return "欺诈"
-	case 20012:
-		return "低俗"
-	case 20013:
-		return "版权"
-	case 21000:
-		return "其他"
-	default:
-		return strconv.Itoa(int(cl))
-	}
-}
-
-// MsgCheckRequest 文本检查请求
-type MsgCheckRequest struct {
-	OpenID    string   `json:"openid"`    // 用户的openid（用户需在近两小时访问过小程序）
-	Scene     MsgScene `json:"scene"`     // 场景枚举值（1 资料；2 评论；3 论坛；4 社交日志）
-	Content   string   `json:"content"`   // 需检测的文本内容，文本字数的上限为 2500 字，需使用 UTF-8 编码
-	Nickname  string   `json:"nickname"`  // （非必填）用户昵称，需使用UTF-8编码
-	Title     string   `json:"title"`     // （非必填）文本标题，需使用UTF-8编码
-	Signature string   `json:"signature"` // （非必填）个性签名，该参数仅在资料类场景有效(scene=1)，需使用UTF-8编码
-}
-
-// MsgCheckResponse 文本检查响应
-type MsgCheckResponse struct {
-	util.CommonError
-	TraceID string `json:"trace_id"` // 唯一请求标识
-	Result  struct {
-		Suggest CheckSuggest `json:"suggest"` // 建议
-		Label   CheckLabel   `json:"label"`   // 命中标签
-	} `json:"result"` // 综合结果
-	Detail []struct {
-		ErrCode  int64      `json:"errcode"`  // 错误码，仅当该值为0时，该项结果有效
-		Strategy string     `json:"strategy"` // 策略类型
-		Suggest  string     `json:"suggest"`  // 建议
-		Label    CheckLabel `json:"label"`    // 命中标签
-		Prob     uint       `json:"prob"`     // 置信度。0-100，越高代表越有可能属于当前返回的标签（label）
-		Keyword  string     `json:"keyword"`  // 命中的自定义关键词
-	} `json:"detail"` // 详细检测结果
-}
-
-// MsgCheckV1 检查一段文本是否含有违法违规内容
-// Deprecated
-// 在2021年9月1日停止更新，请尽快更新至 2.0 接口。建议使用 MsgCheck
-func (security *Security) MsgCheckV1(content string) (res MsgCheckResponse, err error) {
-	accessToken, err := security.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	var req struct {
-		Content string `json:"content"`
-	}
-	req.Content = content
-
-	uri := fmt.Sprintf(msgCheckURL, accessToken)
-	response, err := util.PostJSON(uri, req)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &res, "security.MsgCheckV1")
-	return
-}
-
-// MsgCheck 检查一段文本是否含有违法违规内容
-func (security *Security) MsgCheck(in *MsgCheckRequest) (res MsgCheckResponse, err error) {
-	accessToken, err := security.GetAccessToken()
-	if err != nil {
-		return
-	}
-
-	var req struct {
-		MsgCheckRequest
-		Version uint `json:"version"`
-	}
-	req.MsgCheckRequest = *in
-	req.Version = 2
-
-	uri := fmt.Sprintf(msgCheckURL, accessToken)
-	response, err := util.PostJSON(uri, req)
-	if err != nil {
-		return
-	}
-
-	// 使用通用方法返回错误
-	err = util.DecodeWithError(response, &res, "security.MsgCheck")
-	return
-}

miniprogram/shortlink/shortlink.go

@@ -1,82 +0,0 @@
-package shortlink
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	generateShortLinkURL = "https://api.weixin.qq.com/wxa/genwxashortlink?access_token=%s"
-)
-
-// ShortLink 短链接
-type ShortLink struct {
-	*context.Context
-}
-
-// NewShortLink 实例
-func NewShortLink(ctx *context.Context) *ShortLink {
-	return &ShortLink{ctx}
-}
-
-// ShortLinker 请求结构体
-type ShortLinker struct {
-
-	// pageUrl 通过 Short Link 进入的小程序页面路径，必须是已经发布的小程序存在的页面，可携带 query，最大 1024 个字符
-	PageURL string `json:"page_url"`
-
-	// pageTitle 页面标题，不能包含违法信息，超过 20 字符会用... 截断代替
-	PageTitle string `json:"page_title"`
-
-	// isPermanent 生成的 Short Link 类型，短期有效：false，永久有效：true
-	IsPermanent bool `json:"is_permanent,omitempty"`
-}
-
-// resShortLinker 返回结构体
-type resShortLinker struct {
-	// 通用错误
-	util.CommonError
-
-	// 返回的 shortLink
-	Link string `json:"link"`
-}
-
-// Generate 生成 shortLink
-func (shortLink *ShortLink) generate(shortLinkParams ShortLinker) (string, error) {
-	var accessToken string
-	accessToken, err := shortLink.GetAccessToken()
-	if err != nil {
-		return "", err
-	}
-
-	urlStr := fmt.Sprintf(generateShortLinkURL, accessToken)
-	response, err := util.PostJSON(urlStr, shortLinkParams)
-	if err != nil {
-		return "", err
-	}
-
-	// 使用通用方法返回错误
-	var res resShortLinker
-	err = util.DecodeWithError(response, &res, "GenerateShortLink")
-	return res.Link, err
-}
-
-// GenerateShortLinkPermanent 生成永久 shortLink
-func (shortLink *ShortLink) GenerateShortLinkPermanent(PageURL, pageTitle string) (string, error) {
-	return shortLink.generate(ShortLinker{
-		PageURL:     PageURL,
-		PageTitle:   pageTitle,
-		IsPermanent: true,
-	})
-}
-
-// GenerateShortLinkTemp 生成临时 shortLink
-func (shortLink *ShortLink) GenerateShortLinkTemp(PageURL, pageTitle string) (string, error) {
-	return shortLink.generate(ShortLinker{
-		PageURL:     PageURL,
-		PageTitle:   pageTitle,
-		IsPermanent: false,
-	})
-}

miniprogram/sns.go

@@ -0,0 +1,40 @@
+package miniprogram
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/silenceper/wechat/util"
+)
+
+const (
+	code2SessionURL = "https://api.weixin.qq.com/sns/jscode2session?appid=%s&secret=%s&js_code=%s&grant_type=authorization_code"
+)
+
+// ResCode2Session 登录凭证校验的返回结果
+type ResCode2Session struct {
+	util.CommonError
+
+	OpenID     string `json:"openid"`      // 用户唯一标识
+	SessionKey string `json:"session_key"` // 会话密钥
+	UnionID    string `json:"unionid"`     // 用户在开放平台的唯一标识符，在满足UnionID下发条件的情况下会返回
+}
+
+// Code2Session 登录凭证校验
+func (wxa *MiniProgram) Code2Session(jsCode string) (result ResCode2Session, err error) {
+	urlStr := fmt.Sprintf(code2SessionURL, wxa.AppID, wxa.AppSecret, jsCode)
+	var response []byte
+	response, err = util.HTTPGet(urlStr)
+	if err != nil {
+		return
+	}
+	err = json.Unmarshal(response, &result)
+	if err != nil {
+		return
+	}
+	if result.ErrCode != 0 {
+		err = fmt.Errorf("Code2Session error : errcode=%v , errmsg=%v", result.ErrCode, result.ErrMsg)
+		return
+	}
+	return
+}

miniprogram/subscribe/subscribe.go

@@ -1,191 +0,0 @@
-package subscribe
-
-import (
-	"fmt"
-
-	"github.com/silenceper/wechat/v2/miniprogram/context"
-	"github.com/silenceper/wechat/v2/util"
-)
-
-const (
-	// 发送订阅消息
-	// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
-	subscribeSendURL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send"
-
-	// 获取当前帐号下的个人模板列表
-	// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.getTemplateList.html
-	getTemplateURL = "https://api.weixin.qq.com/wxaapi/newtmpl/gettemplate"
-
-	// 添加订阅模板
-	// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.addTemplate.html
-	addTemplateURL = "https://api.weixin.qq.com/wxaapi/newtmpl/addtemplate"
-
-	// 删除私有模板
-	// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.deleteTemplate.html
-	delTemplateURL = "https://api.weixin.qq.com/wxaapi/newtmpl/deltemplate"
-
-	// 统一服务消息
-	// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/uniform-message/uniformMessage.send.html
-	uniformMessageSend = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send"
-)
-
-// Subscribe 订阅消息
-type Subscribe struct {
-	*context.Context
-}
-
-// NewSubscribe 实例化
-func NewSubscribe(ctx *context.Context) *Subscribe {
-	return &Subscribe{Context: ctx}
-}
-
-// Message 订阅消息请求参数
-type Message struct {
-	ToUser           string               `json:"touser"`            // 必选，接收者（用户）的 openid
-	TemplateID       string               `json:"template_id"`       // 必选，所需下发的订阅模板id
-	Page             string               `json:"page"`              // 可选，点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
-	Data             map[string]*DataItem `json:"data"`              // 必选, 模板内容
-	MiniprogramState string               `json:"miniprogram_state"` // 可选，跳转小程序类型：developer为开发版；trial为体验版；formal为正式版；默认为正式版
-	Lang             string               `json:"lang"`              // 入小程序查看”的语言类型，支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文)，默认为zh_CN
-}
-
-// DataItem 模版内某个 .DATA 的值
-type DataItem struct {
-	Value interface{} `json:"value"`
-	Color string      `json:"color"`
-}
-
-// TemplateItem template item
-type TemplateItem struct {
-	PriTmplID string `json:"priTmplId"`
-	Title     string `json:"title"`
-	Content   string `json:"content"`
-	Example   string `json:"example"`
-	Type      int64  `json:"type"`
-}
-
-// TemplateList template list
-type TemplateList struct {
-	util.CommonError
-	Data []TemplateItem `json:"data"`
-}
-
-// Send 发送订阅消息
-func (s *Subscribe) Send(msg *Message) (err error) {
-	var accessToken string
-	accessToken, err = s.GetAccessToken()
-	if err != nil {
-		return
-	}
-	uri := fmt.Sprintf("%s?access_token=%s", subscribeSendURL, accessToken)
-	response, err := util.PostJSON(uri, msg)
-	if err != nil {
-		return
-	}
-	return util.DecodeWithCommonError(response, "Send")
-}
-
-// ListTemplates 获取当前帐号下的个人模板列表
-// https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.getTemplateList.html
-func (s *Subscribe) ListTemplates() (*TemplateList, error) {
-	accessToken, err := s.GetAccessToken()
-	if err != nil {
-		return nil, err
-	}
-	uri := fmt.Sprintf("%s?access_token=%s", getTemplateURL, accessToken)
-	response, err := util.HTTPGet(uri)
-	if err != nil {
-		return nil, err
-	}
-	templateList := TemplateList{}
-	err = util.DecodeWithError(response, &templateList, "ListTemplates")
-	if err != nil {
-		return nil, err
-	}
-	return &templateList, nil
-}
-
-// UniformMessage 统一服务消息
-type UniformMessage struct {
-	ToUser           string `json:"touser"`
-	WeappTemplateMsg struct {
-		TemplateID      string               `json:"template_id"`
-		Page            string               `json:"page"`
-		FormID          string               `json:"form_id"`
-		Data            map[string]*DataItem `json:"data"`
-		EmphasisKeyword string               `json:"emphasis_keyword"`
-	} `json:"weapp_template_msg"`
-	MpTemplateMsg struct {
-		Appid       string `json:"appid"`
-		TemplateID  string `json:"template_id"`
-		URL         string `json:"url"`
-		Miniprogram struct {
-			Appid    string `json:"appid"`
-			Pagepath string `json:"pagepath"`
-		} `json:"miniprogram"`
-		Data map[string]*DataItem `json:"data"`
-	} `json:"mp_template_msg"`
-}
-
-// UniformSend 发送统一服务消息
-func (s *Subscribe) UniformSend(msg *UniformMessage) (err error) {
-	var accessToken string
-	accessToken, err = s.GetAccessToken()
-	if err != nil {
-		return
-	}
-	uri := fmt.Sprintf("%s?access_token=%s", uniformMessageSend, accessToken)
-	response, err := util.PostJSON(uri, msg)
-	if err != nil {
-		return
-	}
-	return util.DecodeWithCommonError(response, "UniformSend")
-}
-
-type resSubscribeAdd struct {
-	util.CommonError
-
-	TemplateID string `json:"priTmplId"`
-}
-
-// Add 添加订阅消息模板
-func (s *Subscribe) Add(ShortID string, kidList []int, sceneDesc string) (templateID string, err error) {
-	var accessToken string
-	accessToken, err = s.GetAccessToken()
-	if err != nil {
-		return
-	}
-	var msg = struct {
-		TemplateIDShort string `json:"tid"`
-		SceneDesc       string `json:"sceneDesc"`
-		KidList         []int  `json:"kidList"`
-	}{TemplateIDShort: ShortID, SceneDesc: sceneDesc, KidList: kidList}
-	uri := fmt.Sprintf("%s?access_token=%s", addTemplateURL, accessToken)
-	var response []byte
-	response, err = util.PostJSON(uri, msg)
-	if err != nil {
-		return
-	}
-	var result resSubscribeAdd
-	err = util.DecodeWithError(response, &result, "AddSubscribe")
-	return result.TemplateID, err
-}
-
-// Delete 删除私有模板
-func (s *Subscribe) Delete(templateID string) (err error) {
-	var accessToken string
-	accessToken, err = s.GetAccessToken()
-	if err != nil {
-		return
-	}
-	var msg = struct {
-		TemplateID string `json:"priTmplId"`
-	}{TemplateID: templateID}
-	uri := fmt.Sprintf("%s?access_token=%s", delTemplateURL, accessToken)
-	var response []byte
-	response, err = util.PostJSON(uri, msg)
-	if err != nil {
-		return
-	}
-	return util.DecodeWithCommonError(response, "DeleteSubscribe")
-}