微信公众号开发者文档指南
API概述
微信公众号API为开发者提供与微信生态交互的技术接口,涵盖消息管理、用户管理、菜单配置、素材管理等核心功能,所有接口均基于HTTPS协议,采用JSON/XML数据格式,支持OAuth2.0授权与开放平台接入。
核心功能接口
基础能力
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
{ "access_token": "ACCESS_TOKEN", "expires_in": 7200 }
消息管理
接收用户消息
消息类型:文本、图片、语音、事件推送等
数据格式:XML
解密要求:需启用消息加密模式(AES算法)
被动回复消息
支持文本、图文、语音回复,需在5秒内响应,否则触发超时重试机制。
菜单管理
https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
{ "button": [ { "type": "view", "name": "官网", "url": "https://example.com" } ] }
用户管理
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN
openid
、nickname
、city
、subscribe_time
等。开发流程指南
接入准备
AppID
和AppSecret
,配置服务器白名单IP。 接口调用规范
40001
表示无效access_token)。 最佳实践
性能优化
access_token
,避免频繁调用。 用户体验提升
web_access_token
实现网页授权登录(snsapi_userinfo)。 常见问题(FAQ)
接口返回“48001”错误?
原因:接口权限未开通,需检查公众号类型(订阅号/服务号)及权限列表。
用户消息重复接收?
MsgId
进行去重。如何获取用户手机号?
<button open-type="getPhoneNumber">
组件触发。引用说明 参考自微信官方文档:微信开放文档,接口参数及限制以官方最新版本为准。