微信公众号API文档 本文档提供微信公众号开发所需的API接口详细说明,包括接口调用方式、参数说明、返回结果和示例代码。
API概述 微信公众号API主要分为以下几类:
基础接口:获取access_token、获取微信服务器IP等消息管理:接收消息、发送消息、模板消息等用户管理:用户标签、用户信息、用户分组等素材管理:上传下载素材、获取素材列表等自定义菜单:创建、查询、删除自定义菜单账号管理:生成带参数二维码、短链接等数据统计:用户分析、图文分析、消息分析等微信支付:统一下单、查询订单、退款等(仅服务号)微信卡券:创建卡券、管理卡券等(仅服务号)调用规则 接口调用凭证 大部分API需要使用access_token作为调用凭证,获取方式如下:
httpGET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET返回结果:
json{
"access_token": "ACCESS_TOKEN",
"expires_in": 7200
}注意
access_token有效期为7200秒(2小时)请妥善保存AppSecret,避免泄露请合理缓存access_token,避免频繁刷新请求格式 GET请求:参数直接拼接在URL中POST请求:参数以JSON格式提交,Content-Type为application/json返回格式 所有接口均返回JSON格式数据,一般包含以下字段:
成功返回:包含业务数据失败返回:包含errcode和errmsgjson{
"errcode": 40001,
"errmsg": "invalid credential"
}错误码 常见错误码及解决方案:
错误码说明解决方案-1系统繁忙稍后重试0请求成功-40001获取access_token时AppSecret错误检查AppSecret是否正确40002不合法的凭证类型检查grant_type是否正确40003不合法的OpenID检查OpenID是否正确40013不合法的AppID检查AppID是否正确40014不合法的access_token重新获取access_token41001缺少access_token参数检查请求是否包含access_token42001access_token已过期重新获取access_token45009接口调用超过限制减少接口调用频率50001用户未授权该接口检查公众号是否有调用该接口的权限接口列表 请查看以下分类了解详细API:
基础接口消息接口用户管理素材管理SDK与工具 为了简化开发,我们推荐使用以下SDK和工具:
wechat-nodejs-sdk - Node.js SDKEasyWeChat - PHP SDKWeiXinMPSDK - .NET SDKweixin-java-tools - Java SDK微信开发者工具 - 官方开发工具