Loading [MathJax]/jax/output/CommonHTML/config.js
前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >微信公众平台-微信服务号开发

微信公众平台-微信服务号开发

作者头像
全栈程序员站长
发布于 2022-07-28 09:15:48
发布于 2022-07-28 09:15:48
8.4K00
代码可运行
举报
运行总次数:0
代码可运行

大家好,又见面了,我是你们的朋友全栈君。

文章目录

背景:

近期接到了涉及微信开放平台和微信公众平台相关的开发需求,开发过程中踩了许多坑,把相关问题整理记录下来以便巩固记忆,并把总结的经验分享出来,本篇分享微信服务号开发,希望可以给大家提供帮助

一、微信各个平台介绍

1、微信开放平台:面向开发人员,为网站、App提供微信第三方登录功能,为App提供支付功能。

2、微信公众平台:对应的是公众号,包括订阅号、服务号、企业号,面向运营人员和开发人员,运营可以直接登录公众号管理后台查看公众号的整体情况,开发人员则是通过调用微信提供的各种接口来增强公众号的功能;

3、微信商户平台,用户通过微信支付的钱,最终到达商户账号。无论是开放平台还是公众平台,涉及到支付,都需要商户平台账号

解释一下什么是服务号什么是订阅号

通过官方提供的图片可以了解到,订阅号的优势就是进行消息推送,而服务号的优势是能够提供个性化的服务

二、公众平台介绍

公众平台只能通过管理员扫码登录,当运营、开发人员较多时,可以进行绑定运营/开发者微信号进行自行扫码登录(http://kf.qq.com/faq/120911VrYVrA141211FbEnq2.html)

登录后可以在管理后台进行一系列操作,例如:

  • 创作管理:图文素材、多媒体素材上传
  • 公众号设置:设置公众号关注回复内容,收到关键词回复规则和内容,设置收到消息自动回复内容,自定义公众号菜单 (注意:如果在开发者中心开启回调URL和Token进行公众号二次开发后,官方提供的公众号设置功能将被关闭,后面我会针对这个场景做介绍)
  • 管理功能:查看关注该公众号的用户、接收的用户消息,可以通过管理后台对关注的用户进行消息回复、消息群发
  • 统计功能:用户分析、内容分析、菜单分析、图文分析、消息分析等

三、开发前准备

  • 公众号开发切记保存好AppID和AppSecret信息(请求获取AccessToken时用到),其中AppSecret在管理后台不显示,且无法查看,忘记只能重置,因此AppSecret一定要进行备份并注意防止泄露。 (官方对AccessToken进行了详细说明https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html
  • 设置开发环境、测试环境、正式环境的服务器 IP为白名单,白名单以外的ip请求access_token接口会报40164错误,有了 access_token 才能调用微信的各种接口

四、服务器配置

开启服务器配置,开启以后服务号的推送信息将会传送到所配置的服务器中,包括关注事件、事件回复、关键词回复、用户消息接收、自定义菜单等功能都将被服务器接管,并且在公众平台配置的一切推送规则都将被停用,需要注意。

(PS:在配置服务器URL时,由于微信会发送请求进行签名校验,填写的URL必须是可以外网访问的,开发时建议使用ngrok进行内网穿透方便调试 附上网址: https://ngrok.com/

其他详情可以参考服务器配置接入指南(https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html

五、服务器验证

开发者提交信息后,微信服务器将发送GET请求到填写的服务器地址URL上,GET请求携带参数如下表所示:

参数

描述

signature

微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。

timestamp

时间戳

nonce

随机数

echostr

随机字符串

开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。加密/校验流程如下:

1)将token、timestamp、nonce三个参数进行字典序排序

2)将三个参数字符串拼接成一个字符串进行sha1加密

3)开发者获得加密后的字符串可与signature对比,标识该请求来源于微信

代码示例:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
代码示例:
//解析
@GetMapping("/weChatParseXml")
public String parseXmlGet(@RequestParam("signature") String signature,
@RequestParam("timestamp") String timestamp,
@RequestParam("nonce") String nonce,
@RequestParam("echostr") String echostr) {
logger.info("signature: " + signature);
logger.info("timestamp: " + timestamp);
logger.info("nonce: " + nonce);
logger.info("echostr: " + echostr);
//排序
String[] strArray = {TOKEN, timestamp, nonce}; //TOKEN为公众平台填写的Token
Arrays.sort(strArray);
StringBuilder sb = new StringBuilder();
for (String str : strArray) {
sb.append(str);
}
String sortString = sb.toString();
logger.info("sortString: " + sortString);
//加密  这里主要是进行sha1加密 可以使用 SecurityUtil工具类进行加密
String myString = weChatAppletBiz.weChatParseXmlSha1(sortString);
logger.info("myString: " + myString);
//校验
if (myString != null && myString != "" && myString.equals(signature)) {
logger.info("签名校验通过");
//如果检验成功原样返回echostr,微信服务器接收到此输出,才会确认检验完成。
return echostr;
} else {
logger.info("签名校验失败");
return "";
}
}

六、消息接收

当普通微信用户向公众账号发消息时,微信服务器将POST消息的XML数据包到开发者填写的URL上。

(PS:官方提供了对文本、图片、语音、视频、地理位置等消息接收的方法,一般对文本的解析足以满足大部分需求,因此下面只针对文本解析进行说明,其他详情可以查阅上面的服务器接入指南)

请注意:

  1. 关于重试的消息排重,推荐使用msgid排重。
  2. 微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。假如服务器无法保证在五秒内处理并回复,可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。详情请见“发送消息-被动回复消息”。
  3. 如果开发者需要对用户消息在5秒内立即做出回应,即使用“发送消息-被动回复消息”接口向用户被动回复消息时,可以在

公众平台官网的开发者中心处设置消息加密。开启加密后,用户发来的消息和开发者回复的消息都会被加密(但开发者通过客服接口等API调用形式向用户发送消息,则不受影响)。关于消息加解密的详细说明,请见“发送消息-被动回复消息加解密说明”。 关于文本消息的推送XML数据包结构如下:

文本消息

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1348831860</CreateTime>
  <MsgType><![CDATA[text]]></MsgType>
  <Content><![CDATA[this is a test]]></Content>
  <MsgId>1234567890123456</MsgId>
</xml>

参数

描述

ToUserName

开发者微信号

FromUserName

发送方帐号(一个OpenID)

CreateTime

消息创建时间 (整型)

MsgType

消息类型,文本为text

Content

文本消息内容

MsgId

消息id,64位整型

代码示例:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
@PostMapping("/weChatParseXml")
public Object parseXmlPost(HttpServletRequest request) throws Exception {
logger.info("==================接收到微信消息==================");
//解析xml
// Map<String, String> stringStringMap = weChatAppletBiz.parseXml(request);


Map<String, String> messageMap = new HashMap<>();

// 从request中取得输入流
InputStream inputStream = request.getInputStream();
// 读取输入流
SAXReader reader = new SAXReader();
Document document = reader.read(inputStream);
String asXML = document.asXML();
logger.info(asXML);
// 得到xml根元素
Element root = document.getRootElement();
// 得到根元素的所有子节点
List<Element> elementList = root.elements();

// 遍历所有子节点
for (Element e : elementList) {
messageMap.put(e.getName(), e.getText());
}

// 释放资源
inputStream.close();

logger.info("获取到的信息:\n" + messageMap);

weChatAppletBiz.dealWithInfo(messageMap);//该方法内根据用户行为做对应的消息推送

logger.info("==================接收微信消息结束==================");
return "";
}

实际效果:

用户事件:

当服务器后台获取到用户发送的信息后,可以根据Event参数获取事件类型,针对不用的事件进行对应处理

事件类型分为subscribe(订阅)、unsubscribe(取消订阅)、 SCAN(扫描二维码)、 CLICK(菜单点击)、 LOCATION(地理位置)、 VIEW(菜单跳转)

不同事件相关参数也不同,具体还请到上面分享的配置接入指南页面,”消息管理模块-接收事件推送”进行参考

七、客服消息

接口调用请求说明

http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

消息类型分为多种,包含文本、图片、语音、视频、音频、视频、图文、菜单,这里举例几个常用JSON数据包如下:

发送文本消息

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    { 
   
         "content":"Hello World"
    }
}

发送图片消息

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    { 
   
      "media_id":"MEDIA_ID"
    }
}

发送视频消息

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
    "touser":"OPENID",
    "msgtype":"video",
    "video":
    { 
   
      "media_id":"MEDIA_ID",
      "thumb_media_id":"MEDIA_ID",
      "title":"TITLE",
      "description":"DESCRIPTION"
    }
}

发送图文消息(有两种方式,这里举例一种) 注意!!图文消息条数限制在1条以内,如果图文数超过1,则将会返回错误码45008。 这里非常坑!

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
    "touser":"OPENID",
    "msgtype":"mpnews",
    "mpnews":
    { 
   
         "media_id":"MEDIA_ID"
    }
}

发送文本消息时,还支持插入跳小程序的文字链

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
文本内容<a href="[http://www.qq.com](http://www.qq.com/)" data-miniprogram-appid="appid" data-miniprogram-path="pages/index/index">点击跳小程序</a>

说明:

1.data-miniprogram-appid 项,填写小程序appid,则表示该链接跳小程序;

2.data-miniprogram-path项,填写小程序路径,路径与app.json中保持一致,可带参数;

3.对于不支持data-miniprogram-appid 项的客户端版本,如果有herf项,则仍然保持跳href中的网页链接;

4.data-miniprogram-appid对应的小程序必须与公众号有绑定关系。

JSON数据包发送时需要注意以下几点

1、OPENID可以通过接收参数中fromUserName字段获得

2、msgtype一定要遵从规范,否则会出错

3、media_id是管理员自行上传的相关资源,上传成功后会成为微信素材同时生成唯一的media_id,上传方式可以从公众平台页面上传或使用curl命令进行上传

(PS:这里我curl用的很少,大多数资源都是通过公众平台进行上传,而且上传的都是永久素材)

新增永久视频素材的调用示例(慎用):

curl “https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE” -F media=@media.file -F description=’{“title”:VIDEO_TITLE, “introduction”:INTRODUCTION}’

参数说明

参数

是否必须

说明

title

视频素材的标题

introduction

视频素材的描述

返回说明

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
  "media_id":MEDIA_ID,
  "url":URL
}

返回参数说明

参数

描述

media_id

新增的永久素材的media_id

url

新增的图片素材的图片URL(仅新增图片素材时会返回该字段)

八、获取素材

调用微信系统的素材接口可以获取对应的资源列表,注意!!获取资源接口调用时有每日次数限制,不建议实时查询,我这里是通过设计表,找恰当的时机将数据同步到我们自己服务器中。

接口说明:

1、获取永久素材的列表,也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材

2、临时素材无法通过本接口获取

3、调用该接口需https协议

接口调用请求说明

http请求方式:

POST https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN

调用示例

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
    "type":TYPE,
    "offset":OFFSET,
    "count":COUNT
}

参数说明

参数

是否必须

说明

type

素材的类型,图片(image)、视频(video)、语音 (voice)、图文(news)

offset

从全部素材的该偏移位置开始返回,0表示从第一个素材 返回

count

返回素材的数量,取值在1到20之间

返回说明

永久图文消息素材列表的响应如下:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
   "total_count": TOTAL_COUNT,
   "item_count": ITEM_COUNT,
   "item": [{ 
   
       "media_id": MEDIA_ID,
       "content": { 
   
           "news_item": [{ 
   
               "title": TITLE,
               "thumb_media_id": THUMB_MEDIA_ID,
               "show_cover_pic": SHOW_COVER_PIC(0 / 1),
               "author": AUTHOR,
               "digest": DIGEST,
               "content": CONTENT,
               "url": URL,
               "content_source_url": CONTETN_SOURCE_URL
           },
           //多图文消息会在此处有多篇文章
           ]
        },
        "update_time": UPDATE_TIME
    },
    //可能有多个图文消息item结构
  ]
}

其他类型(图片、语音、视频)的返回如下:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
{ 
   
   "total_count": TOTAL_COUNT,
   "item_count": ITEM_COUNT,
   "item": [{ 
   
       "media_id": MEDIA_ID,
       "name": NAME,
       "update_time": UPDATE_TIME,
       "url":URL
   },
   //可能会有多个素材
   ]
}

返回参数说明

参数

描述

total_count

该类型的素材的总数

item_count

本次调用获取的素材的数量

title

图文消息的标题

thumb_media_id

图文消息的封面图片素材id(必须是永久mediaID)

show_cover_pic

是否显示封面,0为false,即不显示,1为true,即显示

author

作者

digest

图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空

content

图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS

url

图文页的URL,或者,当获取的列表是图片素材列表时,该字段是图片的URL

content_source_url

图文消息的原文地址,即点击“阅读原文”后的URL

update_time

这篇图文消息素材的最后更新时间

name

文件名称

九、相关工具

十、最终效果展示

总结

微信开发过程中很容易踩坑,遇到问题建议仔细阅读官方文档或通过微信开放社区寻找帮助

发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/128532.html原文链接:https://javaforall.cn

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2022年4月1,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
暂无评论
推荐阅读
编辑精选文章
换一批
从零实现的Chrome扩展
Chrome扩展是一种可以在Chrome浏览器中添加新功能和修改浏览器行为的软件程序,例如我们常用的TamperMonkey、Proxy SwitchyOmega、AdGuard等等,这些拓展都是可以通过WebExtensions API来修改、增强浏览器的能力,用来提供一些浏览器本体没有的功能,从而实现一些有趣的事情。
WindRunnerMax
2023/07/24
7110
安装量终于破千了!聊聊浏览器扩展开发的相关问题与解决方案
我开发的浏览器扩展安装量终于过千了!在 Firefox AddOns 已经有2.1k+安装,在 Chrome WebStore 已经有2k+安装。实际上在Firefox的扩展市场里是周平均安装量,当天的实际安装量要高出平均值不少,而Chrome的扩展市场在超过1k安装量之后就不精确显示安装量了,实际安装量也会高于1k。
WindRunnerMax
2025/05/22
800
从零实现的浏览器Web脚本
在之前我们介绍了从零实现Chrome扩展,而实际上浏览器级别的扩展整体架构非常复杂,尽管当前有统一规范但不同浏览器的具体实现不尽相同,并且成为开发者并上架Chrome应用商店需要支付5$的注册费,如果我们只是希望在Web页面中进行一些轻量级的脚本编写,使用浏览器扩展级别的能力会显得成本略高,所以在本文我们主要探讨浏览器Web级别的轻量级脚本实现。
WindRunnerMax
2023/11/04
9270
Chrome扩展程开发初探
最近学习了一些前端知识,准备找点方向和项目在工作之余练练手。偶然间被ChatGPT提醒,觉得Chrome拓展开发是一个非常不错的方向。
FunTester
2024/07/30
2610
Chrome扩展程开发初探
chrome浏览器扩展v3版本配置项整理备忘
2、除了在插件内部contenscript background 和 popup之间传递消息以外,其他网站也可以给插件发送消息。方法如下 首先,需要增加配置 externally_connectable:{matches:[“https://*.xxx.com/”]}指定允许哪些网站可以给当前插件发送消息,相当于白名单,只有在白名单中的站点发送的消息,扩展才会监听
fastmock
2023/10/23
6250
浏览器架构的温故知新
【引子】前端可能是一个日新月异的领域,我们很难了解其中的方方面面。但是,前端系统一般都以浏览器作为运行环境, 对浏览器的进一步理解有助于我们更好地开发前端应用。这也是本文的由来之一,也作为对runtime的一次实例分析。
半吊子全栈工匠
2024/03/22
2890
浏览器架构的温故知新
【Chrome】931- 何从零开始开发一个 Chrome 插件?
简单来说浏览器插件,是浏览器上的一种工具,可以提供一些浏览器没有的功能,帮你做一些有趣的事情。开发者可以根据自己的喜欢,去实现一些功能。插件基于Web技术(html、css、js)构建。
pingan8787
2021/04/26
2K0
【Chrome】931- 何从零开始开发一个 Chrome 插件?
【干货】Chrome插件(扩展)开发全攻略
严格来讲,我们正在说的东西应该叫Chrome扩展(Chrome Extension),真正意义上的Chrome插件是更底层的浏览器功能扩展,可能需要对浏览器源码有一定掌握才有能力去开发。鉴于Chrome插件的叫法已经习惯,本文也全部采用这种叫法,但读者需深知本文所描述的Chrome插件实际上指的是Chrome扩展。
winty
2020/07/23
12.1K1
【干货】Chrome插件(扩展)开发全攻略
Chrome扩展开发入门
近几年,随着 IE 浏览器的落幕,Chrome(包括使用Chrome内核的浏览器)其实质上已经垄断整个浏览器行业了,就连微软的 Edge 都用上了 Chrome 内核。 可以说,Chrome 的标准,事实上就可以看做是行业标准了。可以预见,Chrome 的发展前景将会非常广阔。
epoos
2022/09/19
4.2K0
Chrome扩展开发入门
【JS 逆向百例】浏览器插件 Hook 实战,亚航加密参数分析
本文章中所有内容仅供学习交流,抓包内容、敏感网址、数据接口均已做脱敏处理,严禁用于商业用途和非法用途,否则由此产生的一切后果均与作者无关,若有侵权,请联系我立即删除!
K哥爬虫
2021/10/14
6K0
【JS 逆向百例】浏览器插件 Hook 实战,亚航加密参数分析
火狐扩展开发入门实践
题外话: 由于公司内部系统不只支持将后台网页中的数据进行导出为docx或者html而只能打印成PDF,所以为了丰衣足食选择了自己进行开发一个浏览器插件来提取网页中的代码片段与提前设置好的html模板将获取的html进行插入,但是我们需要从基础学习开始一步一步的接触Firefox扩展软件的开发;
全栈工程师修炼指南
2020/10/23
3.2K0
火狐扩展开发入门实践
Chrome插件开发
你只需要看完上面那篇文章和掌握一些前端开发基础,就足以自行编写一个 Chrome 插件。本文也是基于上面文章加上自己之前写的插件所记。
愧怍
2022/12/27
4.1K0
Chrome插件开发
Chrome扩展开发
注:content_scripts段中的代码会在页面加载对应阶段"document_start", “document_end”, or "document_idle"自动注入 但是脚本运行在与页面独立的上下文中,无法访问到原页面的脚本上下文资源 如需访问原页面脚本上下文,可在content_scripts脚本中将web_accessible_resources段中声明的脚本注入到document中 样例: js/content-script.js
路过君
2020/06/19
9990
浏览器插件开发-manifest文件解读「建议收藏」
"content_security_policy": "script-src 'self' https://*.xxx.com; object-src 'self'"
全栈程序员站长
2022/07/28
2.7K0
干货 | 盘点 Chrome 插件开发中那些关键的点!
最近在开发者模式下调试 Chrome 插件,发现安装扩展后默认会报错误,提示 v2 版本已经废弃,相关 API 功能将在明年不可使用,建议升级到 v3 版本
AirPython
2022/04/06
8080
干货 | 盘点 Chrome 插件开发中那些关键的点!
如何快速地开发一个chrome扩展插件
说到现如今最流行的浏览器,那么一定是chrome,无论是它的速度,还是它的稳定性,还是它的简洁,都让人爱不释手,此外,更多的人选择它的理由是它有着丰富的扩展插件,这些扩展插件让你的浏览器变得异常强大,让你的浏览器不仅仅是浏览器。
程序那些事儿
2023/07/24
6550
如何快速地开发一个chrome扩展插件
Chrome Extension
Chrome插件是一个用Web技术开发、用来增强浏览器功能的软件,它其实就是一个由HTML、CSS、JS、图片等资源组成的一个.crx后缀的压缩包
江米小枣
2020/06/15
3.1K0
从 0 开始入门 Chrome Ext 安全(一) -- 了解一个 Chrome Ext
在2019年初,微软正式选择了Chromium作为默认浏览器,并放弃edge的发展。并在19年4月8日,Edge正式放出了基于Chromium开发的Edge Dev浏览器,并提供了兼容Chrome Ext的配套插件管理。再加上国内的大小国产浏览器大多都是基于Chromium开发的,Chrome的插件体系越来越影响着广大的人群。
Seebug漏洞平台
2019/11/28
1.3K0
Chrome扩展 实现自动页面Video下载 demo
最近在看一些浏览器相关的知识,然后就看到了chrome扩展开发文档,觉得很有意思,就按照文档做了一个最简单的demo实现页面上video的自动下载。
4cos90
2022/02/09
1.5K0
写个自己的chrome插件
有没有好奇chrome[1]插件是用什么做的?像类似掘金插件又是怎么实现的,当我安装稀土掘金插件后,我的导航页都被改掉了,因此你也可以做一个类似的插件,来导航你公司的一些产品,方便快捷的实现你的内部导航
Maic
2022/12/21
2.1K0
写个自己的chrome插件
相关推荐
从零实现的Chrome扩展
更多 >
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
本文部分代码块支持一键运行,欢迎体验
本文部分代码块支持一键运行,欢迎体验