menu.go 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303
  1. package menu
  2. import (
  3. "encoding/json"
  4. "fmt"
  5. "github.com/silenceper/wechat/v2/officialaccount/context"
  6. "github.com/silenceper/wechat/v2/util"
  7. )
  8. const (
  9. menuCreateURL = "https://api.weixin.qq.com/cgi-bin/menu/create"
  10. menuGetURL = "https://api.weixin.qq.com/cgi-bin/menu/get"
  11. menuDeleteURL = "https://api.weixin.qq.com/cgi-bin/menu/delete"
  12. menuAddConditionalURL = "https://api.weixin.qq.com/cgi-bin/menu/addconditional"
  13. menuDeleteConditionalURL = "https://api.weixin.qq.com/cgi-bin/menu/delconditional"
  14. menuTryMatchURL = "https://api.weixin.qq.com/cgi-bin/menu/trymatch"
  15. menuSelfMenuInfoURL = "https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info"
  16. )
  17. // Menu struct
  18. type Menu struct {
  19. *context.Context
  20. }
  21. // reqMenu 设置菜单请求数据
  22. type reqMenu struct {
  23. Button []*Button `json:"button,omitempty"`
  24. MatchRule *MatchRule `json:"matchrule,omitempty"`
  25. }
  26. // reqDeleteConditional 删除个性化菜单请求数据
  27. type reqDeleteConditional struct {
  28. MenuID int64 `json:"menuid"`
  29. }
  30. // reqMenuTryMatch 菜单匹配请求
  31. type reqMenuTryMatch struct {
  32. UserID string `json:"user_id"`
  33. }
  34. // resConditionalMenu 个性化菜单返回结果
  35. type resConditionalMenu struct {
  36. Button []Button `json:"button"`
  37. MatchRule MatchRule `json:"matchrule"`
  38. MenuID int64 `json:"menuid"`
  39. }
  40. // resMenuTryMatch 菜单匹配请求结果
  41. type resMenuTryMatch struct {
  42. util.CommonError
  43. Button []Button `json:"button"`
  44. }
  45. // ResMenu 查询菜单的返回数据
  46. type ResMenu struct {
  47. util.CommonError
  48. Menu struct {
  49. Button []Button `json:"button"`
  50. MenuID int64 `json:"menuid"`
  51. } `json:"menu"`
  52. Conditionalmenu []resConditionalMenu `json:"conditionalmenu"`
  53. }
  54. // ResSelfMenuInfo 自定义菜单配置返回结果
  55. type ResSelfMenuInfo struct {
  56. util.CommonError
  57. IsMenuOpen int32 `json:"is_menu_open"`
  58. SelfMenuInfo struct {
  59. Button []SelfMenuButton `json:"button"`
  60. } `json:"selfmenu_info"`
  61. }
  62. // SelfMenuButton 自定义菜单配置详情
  63. type SelfMenuButton struct {
  64. Type string `json:"type"`
  65. Name string `json:"name"`
  66. Key string `json:"key"`
  67. URL string `json:"url,omitempty"`
  68. Value string `json:"value,omitempty"`
  69. SubButton struct {
  70. List []SelfMenuButton `json:"list"`
  71. } `json:"sub_button,omitempty"`
  72. NewsInfo struct {
  73. List []ButtonNew `json:"list"`
  74. } `json:"news_info,omitempty"`
  75. }
  76. // ButtonNew 图文消息菜单
  77. type ButtonNew struct {
  78. Title string `json:"title"`
  79. Author string `json:"author"`
  80. Digest string `json:"digest"`
  81. ShowCover int32 `json:"show_cover"`
  82. CoverURL string `json:"cover_url"`
  83. ContentURL string `json:"content_url"`
  84. SourceURL string `json:"source_url"`
  85. }
  86. // MatchRule 个性化菜单规则
  87. type MatchRule struct {
  88. GroupID string `json:"group_id,omitempty"`
  89. Sex string `json:"sex,omitempty"`
  90. Country string `json:"country,omitempty"`
  91. Province string `json:"province,omitempty"`
  92. City string `json:"city,omitempty"`
  93. ClientPlatformType string `json:"client_platform_type,omitempty"`
  94. Language string `json:"language,omitempty"`
  95. }
  96. // NewMenu 实例
  97. func NewMenu(context *context.Context) *Menu {
  98. menu := new(Menu)
  99. menu.Context = context
  100. return menu
  101. }
  102. // SetMenu 设置按钮
  103. func (menu *Menu) SetMenu(buttons []*Button) error {
  104. accessToken, err := menu.GetAccessToken()
  105. if err != nil {
  106. return err
  107. }
  108. uri := fmt.Sprintf("%s?access_token=%s", menuCreateURL, accessToken)
  109. reqMenu := &reqMenu{
  110. Button: buttons,
  111. }
  112. response, err := util.PostJSON(uri, reqMenu)
  113. if err != nil {
  114. return err
  115. }
  116. return util.DecodeWithCommonError(response, "SetMenu")
  117. }
  118. // SetMenuByJSON 设置按钮
  119. func (menu *Menu) SetMenuByJSON(jsonInfo string) error {
  120. accessToken, err := menu.GetAccessToken()
  121. if err != nil {
  122. return err
  123. }
  124. uri := fmt.Sprintf("%s?access_token=%s", menuCreateURL, accessToken)
  125. response, err := util.HTTPPost(uri, jsonInfo)
  126. if err != nil {
  127. return err
  128. }
  129. return util.DecodeWithCommonError(response, "SetMenuByJSON")
  130. }
  131. // GetMenu 获取菜单配置
  132. func (menu *Menu) GetMenu() (resMenu ResMenu, err error) {
  133. var accessToken string
  134. accessToken, err = menu.GetAccessToken()
  135. if err != nil {
  136. return
  137. }
  138. uri := fmt.Sprintf("%s?access_token=%s", menuGetURL, accessToken)
  139. var response []byte
  140. response, err = util.HTTPGet(uri)
  141. if err != nil {
  142. return
  143. }
  144. err = json.Unmarshal(response, &resMenu)
  145. if err != nil {
  146. return
  147. }
  148. if resMenu.ErrCode != 0 {
  149. err = fmt.Errorf("GetMenu Error , errcode=%d , errmsg=%s", resMenu.ErrCode, resMenu.ErrMsg)
  150. return
  151. }
  152. return
  153. }
  154. // DeleteMenu 删除菜单
  155. func (menu *Menu) DeleteMenu() error {
  156. accessToken, err := menu.GetAccessToken()
  157. if err != nil {
  158. return err
  159. }
  160. uri := fmt.Sprintf("%s?access_token=%s", menuDeleteURL, accessToken)
  161. response, err := util.HTTPGet(uri)
  162. if err != nil {
  163. return err
  164. }
  165. return util.DecodeWithCommonError(response, "GetMenu")
  166. }
  167. // AddConditional 添加个性化菜单
  168. func (menu *Menu) AddConditional(buttons []*Button, matchRule *MatchRule) error {
  169. accessToken, err := menu.GetAccessToken()
  170. if err != nil {
  171. return err
  172. }
  173. uri := fmt.Sprintf("%s?access_token=%s", menuAddConditionalURL, accessToken)
  174. reqMenu := &reqMenu{
  175. Button: buttons,
  176. MatchRule: matchRule,
  177. }
  178. response, err := util.PostJSON(uri, reqMenu)
  179. if err != nil {
  180. return err
  181. }
  182. return util.DecodeWithCommonError(response, "AddConditional")
  183. }
  184. // AddConditionalByJSON 添加个性化菜单
  185. func (menu *Menu) AddConditionalByJSON(jsonInfo string) error {
  186. accessToken, err := menu.GetAccessToken()
  187. if err != nil {
  188. return err
  189. }
  190. uri := fmt.Sprintf("%s?access_token=%s", menuAddConditionalURL, accessToken)
  191. response, err := util.HTTPPost(uri, jsonInfo)
  192. if err != nil {
  193. return err
  194. }
  195. return util.DecodeWithCommonError(response, "AddConditional")
  196. }
  197. // DeleteConditional 删除个性化菜单
  198. func (menu *Menu) DeleteConditional(menuID int64) error {
  199. accessToken, err := menu.GetAccessToken()
  200. if err != nil {
  201. return err
  202. }
  203. uri := fmt.Sprintf("%s?access_token=%s", menuDeleteConditionalURL, accessToken)
  204. reqDeleteConditional := &reqDeleteConditional{
  205. MenuID: menuID,
  206. }
  207. response, err := util.PostJSON(uri, reqDeleteConditional)
  208. if err != nil {
  209. return err
  210. }
  211. return util.DecodeWithCommonError(response, "DeleteConditional")
  212. }
  213. // MenuTryMatch 菜单匹配
  214. func (menu *Menu) MenuTryMatch(userID string) (buttons []Button, err error) {
  215. var accessToken string
  216. accessToken, err = menu.GetAccessToken()
  217. if err != nil {
  218. return
  219. }
  220. uri := fmt.Sprintf("%s?access_token=%s", menuTryMatchURL, accessToken)
  221. reqMenuTryMatch := &reqMenuTryMatch{userID}
  222. var response []byte
  223. response, err = util.PostJSON(uri, reqMenuTryMatch)
  224. if err != nil {
  225. return
  226. }
  227. var resMenuTryMatch resMenuTryMatch
  228. err = json.Unmarshal(response, &resMenuTryMatch)
  229. if err != nil {
  230. return
  231. }
  232. if resMenuTryMatch.ErrCode != 0 {
  233. err = fmt.Errorf("MenuTryMatch Error , errcode=%d , errmsg=%s", resMenuTryMatch.ErrCode, resMenuTryMatch.ErrMsg)
  234. return
  235. }
  236. buttons = resMenuTryMatch.Button
  237. return
  238. }
  239. // GetCurrentSelfMenuInfo 获取自定义菜单配置接口
  240. func (menu *Menu) GetCurrentSelfMenuInfo() (resSelfMenuInfo ResSelfMenuInfo, err error) {
  241. var accessToken string
  242. accessToken, err = menu.GetAccessToken()
  243. if err != nil {
  244. return
  245. }
  246. uri := fmt.Sprintf("%s?access_token=%s", menuSelfMenuInfoURL, accessToken)
  247. var response []byte
  248. response, err = util.HTTPGet(uri)
  249. if err != nil {
  250. return
  251. }
  252. err = json.Unmarshal(response, &resSelfMenuInfo)
  253. if err != nil {
  254. return
  255. }
  256. if resSelfMenuInfo.ErrCode != 0 {
  257. err = fmt.Errorf("GetCurrentSelfMenuInfo Error , errcode=%d , errmsg=%s", resSelfMenuInfo.ErrCode, resSelfMenuInfo.ErrMsg)
  258. return
  259. }
  260. return
  261. }