手册目录

微信公众平台开发概述

微信公众平台开发概述微信开发者规范微信公众号接口权限说明微信公众号接口调用频次限制说明

开始开发

微信开发者平台接入指南微信公众平台接口域名说明微信公众平台获取access_token 获取微信服务器IP地址报警排查指引接口测试号申请

微信自定义开发

自定义菜单创建接口自定义菜单查询接口自定义菜单删除接口自定义菜单事件推送个性化菜单接口获取自定义菜单配置接口

消息管理

接收普通消息接收事件推送被动回复用户消息消息加解密说明客服消息高级群发接口模板消息接口模板消息运营规范获取公众号的自动回复规则

微信网页开发

微信网页授权微信网页开发样式库微信JS-SDK说明文档微信web开发者工具

素材管理

新增临时素材获取临时素材新增永久素材删除永久素材修改永久图文素材获取素材总数获取素材列表

用户管理

用户标签管理设置用户备注名获取用户基本信息(UnionID机制) 获取用户列表获取用户地理位置黑名单管理

账号管理

生成带参数的二维码长链接转短链接接口微信认证事件推送

数据统计

用户分析数据接口图文分析数据接口消息分析数据接口接口分析数据接口

微信卡券接口说明

微信卡券接口创建卡券投放卡券核销卡券管理卡券卡券事件推送会员卡专区（一）会员卡专区（二）朋友的券专区特殊票券第三方开发者模式卡券错误码

微信门店

微信门店接口

微信小店

微信小店接口语义理解接口

微信设备功能

微信服务号设备功能介绍如何新增产品型号

新版客服功能

将消息转发到微信客服微信客服管理微信会话控制微信获取聊天记录

微信摇一摇周边

申请开通微信摇一摇微信设备ID 微信摇一摇页面管理微信摇一摇上传图片素材管理设备与页面的关联关系微信摇一摇数据统计摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息微信摇一摇获取设备及用户信息摇一摇红包介绍说明摇一摇周边错误码

微信连WIFI

微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理配置微信WiFi联网方式微信商家主页管理 Wi-Fi数据统计连网后下发消息微信卡券投放微信Wi-Fi接口返回错误码微信连网过程常见错误码

微信扫一扫

微信扫一扫接入指南微信上进行商品创建微信商品发布微信商品管理扫一扫事件推送一物一码专区扫一扫错误码在线帮助工具

微信公众平台开发者文档

更新时间2022-04-11

长链接转短链接接口

微信认证事件推送

为了帮助公众号开发者获取公众号的认证状态，也为了第三方平台开发者获知旗下公众号的认证状态，微信公众平台提供了公众号认证过程中各个阶段的事件推送。

事件推送到哪里？

1、事件推送将会推送给公众号在公众平台官网开发者中心设置的服务地址中
2、如果公众号已将帐号管理权限集（因为该接口权限从属于帐号管理权限集）授权给第三方平台，那么将由第三方平台代公众号接收事件推送，具体是推送到第三方平台的公众号消息与事件接收URL

请注意：

1、资质认证成功后，公众号就获得了认证相关接口权限，资质认证成功一定发生在名称认证成功之前
2、名称认证成功后，公众号才在微信客户端中获得打勾认证标识

1 资质认证成功（此时立即获得接口权限）

2 资质认证失败

3 名称认证成功（即命名成功）

4 名称认证失败（这时虽然客户端不打勾，但仍有接口权限）

5 年审通知

6 认证过期失效通知

资质认证成功（此时立即获得接口权限）

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 qualification_verify_success
ExpiredTime	有效期 (整形)，指的是时间戳，将于该时间戳认证过期

资质认证失败

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 qualification_verify_fail
FailTime	失败发生时间 (整形)，时间戳
FailReason	认证失败的原因

名称认证成功（即命名成功）

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 naming_verify_success
ExpiredTime	有效期 (整形)，指的是时间戳，将于该时间戳认证过期

名称认证失败（这时虽然客户端不打勾，但仍有接口权限）

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 naming_verify_fail
FailTime	失败发生时间 (整形)，时间戳
FailReason	认证失败的原因

年审通知

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 annual_renew，提醒公众号需要去年审了
ExpiredTime	有效期 (整形)，指的是时间戳，将于该时间戳认证过期，需尽快年审

认证过期失效通知

推送XML数据包示例：

参数说明

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID，此时发送方是系统帐号）
CreateTime	消息创建时间（整型），时间戳
MsgType	消息类型，event
Event	事件类型 verify_expired
ExpiredTime	有效期 (整形)，指的是时间戳，表示已于该时间戳认证过期，需要重新发起微信认证

长链接转短链接接口