全局返回码说明
公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。
全局返回码说明如下：
|
返回码 |
说明 |
|
-1 |
系统繁忙，此时请开发者稍候再试 |
|
0 |
请求成功 |
|
40001 |
获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口 |
|
40002 |
不合法的凭证类型 |
|
40003 |
不合法的 OpenID ，请开发者确认 OpenID （该用户）是否已关注公众号，或是否是其他公众号的 OpenID |
|
40004 |
不合法的媒体文件类型 |
|
40005 |
不合法的文件类型 |
|
40006 |
不合法的文件大小 |
|
40007 |
不合法的媒体文件 id |
|
40008 |
不合法的消息类型 |
|
40009 |
不合法的图片文件大小 |
|
40010 |
不合法的语音文件大小 |
|
40011 |
不合法的视频文件大小 |
|
40012 |
不合法的缩略图文件大小 |
|
40013 |
不合法的 AppID ，请开发者检查 AppID 的正确性，避免异常字符，注意大小写 |
|
40014 |
不合法的 access_token ，请开发者认真比对 access_token 的有效性（如是否过期），或查看是否正在为恰当的公众号调用接口 |
|
40015 |
不合法的菜单类型 |
|
40016 |
不合法的按钮个数 |
|
40017 |
不合法的按钮个数 |
|
40018 |
不合法的按钮名字长度 |
|
40019 |
不合法的按钮 KEY 长度 |
|
40020 |
不合法的按钮 URL 长度 |
|
40021 |
不合法的菜单版本号 |
|
40022 |
不合法的子菜单级数 |
|
40023 |
不合法的子菜单按钮个数 |
|
40024 |
不合法的子菜单按钮类型 |
|
40025 |
不合法的子菜单按钮名字长度 |
|
40026 |
不合法的子菜单按钮 KEY 长度 |
|
40027 |
不合法的子菜单按钮 URL 长度 |
|
40028 |
不合法的自定义菜单使用用户 |
|
40029 |
不合法的 oauth_code |
|
40030 |
不合法的 refresh_token |
|
40031 |
不合法的 openid 列表 |
|
40032 |
不合法的 openid 列表长度 |
|
40033 |
不合法的请求字符，不能包含 uxxxx 格式的字符 |
|
40035 |
不合法的参数 |
|
40038 |
不合法的请求格式 |
|
40039 |
不合法的 URL 长度 |
|
40050 |
不合法的分组 id |
|
40051 |
分组名字不合法 |
|
40060 |
删除单篇图文时，指定的 article_idx 不合法 |
|
40117 |
分组名字不合法 |
|
40118 |
media_id 大小不合法 |
|
40119 |
button 类型错误 |
|
40120 |
button 类型错误 |
|
40121 |
不合法的 media_id 类型 |
|
40132 |
微信号不合法 |
|
40137 |
不支持的图片格式 |
|
40155 |
请勿添加其他公众号的主页链接 |
|
41001 |
缺少 access_token 参数 |
|
41002 |
缺少 appid 参数 |
|
41003 |
缺少 refresh_token 参数 |
|
41004 |
缺少 secret 参数 |
|
41005 |
缺少多媒体文件数据 |
|
41006 |
缺少 media_id 参数 |
|
41007 |
缺少子菜单数据 |
|
41008 |
缺少 oauth code |
|
41009 |
缺少 openid |
|
42001 |
access_token 超时，请检查 access_token 的有效期，请参考基础支持 - 获取 access_token 中，对 access_token 的详细机制说明 |
|
42002 |
refresh_token 超时 |
|
42003 |
oauth_code 超时 |
|
42007 |
用户修改微信密码， accesstoken 和 refreshtoken 失效，需要重新授权 |
|
43001 |
需要 GET 请求 |
|
43002 |
需要 POST 请求 |
|
43003 |
需要 HTTPS 请求 |
|
43004 |
需要接收者关注 |
|
43005 |
需要好友关系 |
|
43019 |
需要将接收者从黑名单中移除 |
|
44001 |
多媒体文件为空 |
|
44002 |
POST 的数据包为空 |
|
44003 |
图文消息内容为空 |
|
44004 |
文本消息内容为空 |
|
45001 |
多媒体文件大小超过限制 |
|
45002 |
消息内容超过限制 |
|
45003 |
标题字段超过限制 |
|
45004 |
描述字段超过限制 |
|
45005 |
链接字段超过限制 |
|
45006 |
图片链接字段超过限制 |
|
45007 |
语音播放时间超过限制 |
|
45008 |
图文消息超过限制 |
|
45009 |
接口调用超过限制 |
|
45010 |
创建菜单个数超过限制 |
|
45011 |
API 调用太频繁，请稍候再试 |
|
45015 |
回复时间超过限制 |
|
45016 |
系统分组，不允许修改 |
|
45017 |
分组名字过长 |
|
45018 |
分组数量超过上限 |
|
45047 |
客服接口下行条数超过上限 |
|
46001 |
不存在媒体数据 |
|
46002 |
不存在的菜单版本 |
|
46003 |
不存在的菜单数据 |
|
46004 |
不存在的用户 |
|
47001 |
解析 JSON/XML 内容错误 |
|
48001 |
api 功能未授权，请确认公众号已获得该接口，可以在公众平台官网 - 开发者中心页中查看接口权限 |
|
48002 |
粉丝拒收消息（粉丝在公众号选项中，关闭了 “ 接收消息 ” ） |
|
48004 |
api 接口被封禁，请登录 mp.weixin.qq.com 查看详情 |
|
48005 |
api 禁止删除被自动回复和自定义菜单引用的素材 |
|
48006 |
api 禁止清零调用次数，因为清零次数达到上限 |
|
48008 |
没有该类型消息的发送权限 |
|
50001 |
用户未授权该 api |
|
50002 |
用户受限，可能是违规后接口被封禁 |
|
61451 |
参数错误 (invalid parameter) |
|
61452 |
无效客服账号 (invalid kf_account) |
|
61453 |
客服帐号已存在 (kf_account exsited) |
|
61454 |
客服帐号名长度超过限制 ( 仅允许 10 个英文字符，不包括 @ 及 @ 后的公众号的微信号 )(invalid kf_acount length) |
|
61455 |
客服帐号名包含非法字符 ( 仅允许英文 + 数字 )(illegal character in kf_account) |
|
61456 |
客服帐号个数超过限制 (10 个客服账号 )(kf_account count exceeded) |
|
61457 |
无效头像文件类型 (invalid file type) |
|
61450 |
系统错误 (system error) |
|
61500 |
日期格式错误 |
|
65301 |
不存在此 menuid 对应的个性化菜单 |
|
65302 |
没有相应的用户 |
|
65303 |
没有默认菜单，不能创建个性化菜单 |
|
65304 |
MatchRule 信息为空 |
|
65305 |
个性化菜单数量受限 |
|
65306 |
不支持个性化菜单的帐号 |
|
65307 |
个性化菜单信息为空 |
|
65308 |
包含没有响应类型的 button |
|
65309 |
个性化菜单开关处于关闭状态 |
|
65310 |
填写了省份或城市信息，国家信息不能为空 |
|
65311 |
填写了城市信息，省份信息不能为空 |
|
65312 |
不合法的国家信息 |
|
65313 |
不合法的省份信息 |
|
65314 |
不合法的城市信息 |
|
65316 |
该公众号的菜单设置了过多的域名外跳（最多跳转到 3 个域名的链接） |
|
65317 |
不合法的 URL |
|
9001001 |
POST 数据参数不合法 |
|
9001002 |
远端服务不可用 |
|
9001003 |
Ticket 不合法 |
|
9001004 |
获取摇周边用户信息失败 |
|
9001005 |
获取商户信息失败 |
|
9001006 |
获取 OpenID 失败 |
|
9001007 |
上传文件缺失 |
|
9001008 |
上传素材的文件类型不合法 |
|
9001009 |
上传素材的文件尺寸不合法 |
|
9001010 |
上传失败 |
|
9001020 |
帐号不合法 |
|
9001021 |
已有设备激活率低于 50% ，不能新增设备 |
|
9001022 |
设备申请数不合法，必须为大于 0 的数字 |
|
9001023 |
已存在审核中的设备 ID 申请 |
|
9001024 |
一次查询设备 ID 数量不能超过 50 |
|
9001025 |
设备 ID 不合法 |
|
9001026 |
页面 ID 不合法 |
|
9001027 |
页面参数不合法 |
|
9001028 |
一次删除页面 ID 数量不能超过 10 |
|
9001029 |
页面已应用在设备中，请先解除应用关系再删除 |
|
9001030 |
一次查询页面 ID 数量不能超过 50 |
|
9001031 |
时间区间不合法 |
|
9001032 |
保存设备与页面的绑定关系参数错误 |
|
9001033 |
门店 ID 不合法 |
|
9001034 |
设备备注信息过长 |
|
9001035 |
设备申请参数不合法 |
|
9001036 |
查询起始值 begin 不合法 |