🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
企业应用每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。 **注意:开发者的程序应该根据errcode来判断出错的情况,而不应该依赖errmsg来匹配,因为errmsg可能会调整。** 如果请求的参数不符合json规范,可能会导致企业微信解析到的参数不完整,此时接口在返回的errmsg里会有“Warning: wrong json format.”,开发者需要重新检查请求参数的json合法性。 全局返回码说明如下: | 错误码 | 错误说明 | 排查方法 | | --- | --- | --- | | \-1 | 系统繁忙 | 服务器暂不可用,建议稍候重试。建议重试次数不超过3次。 | | 0 | 请求成功 | 接口调用成功 | | 40001 | 不合法的secret参数 | secret在开发配置/配置服务页面可查看 | | 40004 | 不合法的媒体文件类型 | 不满足系统文件要求。参考:[[上传的媒体文件限制]](https://www.kancloud.cn/dabashan/qiwei/2376081) | | 40005 | 不合法的type参数 | 合法的type取值,参考:[上传临时素材](https://www.kancloud.cn/dabashan/qiwei/2376081) | | 40006 | 不合法的文件大小 | 系统文件要求,参考:[上传的媒体文件限制](https://www.kancloud.cn/dabashan/qiwei/2376081) | | 40007 | 不合法的media\_id参数 | [看底部) | | 40008 | 不合法的msgtype参数 | 合法的msgtype取值,参考:[消息类型](https://www.kancloud.cn/dabashan/qiwei/2376075) | | 40009 | 上传图片大小不是有效值 | 图片大小的系统限制,参考[上传的媒体文件限制](https://www.kancloud.cn/dabashan/qiwei/2376081) | | 40011 | 上传视频大小不是有效值 | 视频大小的系统限制,参考[上传的媒体文件限制](https://www.kancloud.cn/dabashan/qiwei/2376081) | | 40014 | 不合法的access\_token | [看底部](https://www.kancloud.cn/book/dabashan/qiwei/edit#40007_37) | | 40014 | 不合法的access\_token | [查看帮助](https://www.kancloud.cn/book/dabashan/qiwei/edit#40007_37) | | 90207 | 不合法的小程序appid | \- | | 95000 | 不合法的open\_kfid | \- | | 95001 | 发送客服消息次数限制 | 当用户主动发送消息给微信客服时,企业最多可发送5条消息给用户;若用户继续发送消息,企业可再次下发消息 | | 95002 | 发送客服消息时间限制 | 当用户在主动发送消息给微信客服时,可在48小时内调用该接口发送消息给用户 | | 95003 | 发送客服消息可接待客户咨询数限制 | 企业未验证或未绑定视频号 | | 95004 | open\_kfid不存在 | 跨企业使用,或对已删除的帐号操作 | | 95005 | 客服帐号数超过限制 | 客服账号数不能多于最大的数量限制,且至少有一个 | | 95006 | 不合法的客服帐号名 | \- | | 95007 | 不合法的msgtoken | msgtoken有时效性,可能为失效或者非法 | | 95008 | 菜单消息的菜单项个数超过上限 | 目前最多允许10个菜单项 | | 95009 | 不合法的菜单消息的菜单项类型 | \- | | 95011 | 已在企业微信使用微信客服 | \- | | 95017 | 企业内部自己调用API时,API开关处于关闭状态 | \- | ## 排查方法 * ##### 错误码:40007 不合法的媒体文件。确认: 1)媒体文件ID的获取方式,是否存在。注:上传临时素材生成的medida\_id,有效期是3天。 2)媒体文件类型应符合接口要求(比如发送图片消息,此时不能用音频文件的media\_id)。 * ##### 错误码:40014 access\_token参数错误。确认: 1)access\_token的获取方式 2)access\_token是否已过期 可以重新获取一次access\_token解决