subscribe.go 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. package subscribe
  2. import (
  3. "fmt"
  4. "github.com/silenceper/wechat/v2/miniprogram/context"
  5. "github.com/silenceper/wechat/v2/util"
  6. )
  7. const (
  8. //发送订阅消息
  9. //https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
  10. subscribeSendURL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send"
  11. // 获取当前帐号下的个人模板列表
  12. // https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.getTemplateList.html
  13. getTemplateURL = "https://api.weixin.qq.com/wxaapi/newtmpl/gettemplate"
  14. )
  15. // Subscribe 订阅消息
  16. type Subscribe struct {
  17. *context.Context
  18. }
  19. // NewSubscribe 实例化
  20. func NewSubscribe(ctx *context.Context) *Subscribe {
  21. return &Subscribe{Context: ctx}
  22. }
  23. // Message 订阅消息请求参数
  24. type Message struct {
  25. ToUser string `json:"touser"` //必选,接收者(用户)的 openid
  26. TemplateID string `json:"template_id"` //必选,所需下发的订阅模板id
  27. Page string `json:"page"` //可选,点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。
  28. Data map[string]*DataItem `json:"data"` //必选, 模板内容
  29. MiniprogramState string `json:"miniprogram_state"` //可选,跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版
  30. Lang string `json:"lang"` //入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN
  31. }
  32. //DataItem 模版内某个 .DATA 的值
  33. type DataItem struct {
  34. Value string `json:"value"`
  35. }
  36. type TemplateItem struct {
  37. PriTmplID string `json:"priTmplId"`
  38. Title string `json:"title"`
  39. Content string `json:"content"`
  40. Example string `json:"example"`
  41. Type int64 `json:"type"`
  42. }
  43. type TemplateList struct {
  44. util.CommonError
  45. Data []TemplateItem `json:"data"`
  46. }
  47. // Send 发送订阅消息
  48. func (s *Subscribe) Send(msg *Message) (err error) {
  49. var accessToken string
  50. accessToken, err = s.GetAccessToken()
  51. if err != nil {
  52. return
  53. }
  54. uri := fmt.Sprintf("%s?access_token=%s", subscribeSendURL, accessToken)
  55. response, err := util.PostJSON(uri, msg)
  56. if err != nil {
  57. return
  58. }
  59. return util.DecodeWithCommonError(response, "Send")
  60. }
  61. // 获取当前帐号下的个人模板列表
  62. // https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.getTemplateList.html
  63. func (s *Subscribe) ListTemplates() (*TemplateList, error) {
  64. accessToken, err := s.GetAccessToken()
  65. if err != nil {
  66. return nil, err
  67. }
  68. uri := fmt.Sprintf("%s?access_token=%s", getTemplateURL, accessToken)
  69. response, err := util.HTTPGet(uri)
  70. if err != nil {
  71. return nil, err
  72. }
  73. templateList := TemplateList{}
  74. err = util.DecodeWithError(response, &templateList, "ListTemplates")
  75. if err != nil {
  76. return nil, err
  77. }
  78. return &templateList, nil
  79. }