企业微信接口错误代码大全

╰+哭是因爲堅強的太久メ 2023-10-04 23:15 3阅读 0赞

|-1 | 系统繁忙 | 服务器暂不可用，建议稍候重试。建议重试次数不超过3次。 |

| 0 | 请求成功 | 接口调用成功 |

| 40001 | 不合法的secret参数 | secret在应用详情/通讯录管理助手可查看 |

| 40003 | 无效的UserID | 查看帮助 |

| 40004 | 不合法的媒体文件类型 | 不满足系统文件要求。参考： 上传的媒体文件限制 |

| 40005 | 不合法的type参数 | 合法的type取值，参考： 上传临时素材 |

| 40006 | 不合法的文件大小 | 系统文件要求，参考： 上传的媒体文件限制 |

| 40007 | 不合法的media\_id参数 | 查看帮助 |

| 40008 | 不合法的msgtype参数 | 合法的msgtype取值，参考： 消息类型 |

| 40009 | 上传图片大小不是有效值 | 图片大小的系统限制，参考 上传的媒体文件限制 |

| 40011 | 上传视频大小不是有效值 | 视频大小的系统限制，参考 上传的媒体文件限制 |

| 40013 | 不合法的CorpID | 需确认CorpID是否填写正确，在 web管理端-设置 可查看 |

| 40014 | 不合法的access\_token | 查看帮助 |

| 40016 | 不合法的按钮个数 | 菜单按钮1-3个 |

| 40017 | 不合法的按钮类型 | 支持的类型，参考： 按钮类型 |

| 40018 | 不合法的按钮名字长度 |长度应不超过16个字节 |

| 40019 | 不合法的按钮KEY长度 | 长度应不超过128字节 |

| 40020 | 不合法的按钮URL长度 | 长度应不超过1024字节 |

| 40022 | 不合法的子菜单级数 | 只能包含一级菜单和二级菜单 |

| 40023 | 不合法的子菜单按钮个数 | 子菜单按钮1-5个 |

| 40024 | 不合法的子菜单按钮类型 | 支持的类型，参考： 按钮类型 |

| 40025 | 不合法的子菜单按钮名字长度 | 支持的类型，参考： 按钮类型 |

| 40026 | 不合法的子菜单按钮KEY长度 | - |

| 40027 | 不合法的子菜单按钮URL长度 | 长度应不超过1024字节 |

| 40029 | 不合法的oauth\_code | 查看帮助 |

| 40031 | 不合法的UserID列表 | 指定的UserID列表，至少存在一个UserID不在通讯录中 |

| 40032 | 不合法的UserID列表长度 | 查看帮助 |

| 40033 | 不合法的请求字符 | 不能包含\\uxxxx格式的字符 |

| 40035 | 不合法的参数 | 查看帮助 |

| 40039| 不合法的url长度| url长度限制1024个字节|

| 40050 | chatid不存在 | 会话需要先创建后，才可修改会话详情或者发起聊天 |

| 40054 | 不合法的子菜单url域名 | \[查看帮助\](\#10649/错误码：40054 40055) |

| 40055 | 不合法的菜单url域名 | \[查看帮助\](\#10649/错误码：40054 40055) |

| 40056 | 不合法的agentid | 查看帮助 |

| 40057 | 不合法的callbackurl或者callbackurl验证失败 | 可自助到 开发调试工具重现 |

| 40058 | 不合法的参数 | 传递参数不符合系统要求，需要参照具体API接口说明 |

| 40059 | 不合法的上报地理位置标志位 | 开关标志位只能填 0 或者 1 |

| 40063 | 参数为空 | 查看帮助 |

| 40066 | 不合法的部门列表 | 部门列表为空，或者至少存在一个部门ID不存在于通讯录中 |

| 40068 | 不合法的标签ID | 标签ID未指定，或者指定的标签ID不存在 |

| 40070 | 指定的标签范围结点全部无效 | 查看帮助 |

| 40071 | 不合法的标签名字 | 标签名字已经存在 |

| 40072 | 不合法的标签名字长度 | 不允许为空，最大长度限制为32个字（汉字或英文字母） |

| 40073 | 不合法的openid | openid不存在，需确认获取来源 |

| 40074 | news消息不支持保密消息类型 | 图文消息支持保密类型需改用mpnews |

| 40077 | 不合法的pre\_auth\_code参数 | 预授权码不存在，参考： 获取预授权码 |

| 40078 | 不合法的auth\_code参数 | 需确认获取来源，并且只能消费一次 |

| 40080 | 不合法的suite\_secret | 套件secret可在第三方管理端套件详情查看 |

| 40082 | 不合法的suite\_token | 查看帮助 |

| 40083 | 不合法的suite\_id | suite\_id不存在 |

| 40084 | 不合法的permanent\_code参数 | 查看帮助 |

| 40085 | 不合法的的suite\_ticket参数 | suite\_ticket不存在或者已失效 |

| 40086 | 不合法的第三方应用appid | 至少有一个不存在应用id |

| 40088 | jobid不存在 | 请检查 jobid 来源 |

| 40089 | 批量任务的结果已清理 | 系统仅保存最近5次批量任务的结果。可在通讯录查看实际导入情况 |

| 40091 | secret不合法 | 可能用了别的企业的secret |

| 40092 | 导入文件存在不合法的内容 | 查看帮助 |

| 40093 | jsapi签名错误 | 请检查用于签名的jsapi\_ticket是否是正确的，是否过期。可以通过获取相应jsapi\_ticket接口获取当前的jsapi\_ticket跟用于签名的jsapi\_ticket比对是否一致，若jsapi\_ticket还在有效期内，当前获取到的jsapi\_ticket是一致的。若jsapi\_ticket没问题，请检查用于签名的url参数是不是正确的， url（当前网页的URL， 不包含\#及其后面部分）。|

| 40094 | 不合法的URL | 缺少主页URL参数，或者URL不合法（链接需要带上协议头，以 http:// 或者 https:// 开头） |

| 40096 | 不合法的外部联系人userid | - |

|40097|该成员尚未离职|离职成员外部联系人转移接口要求转出用户必须已经离职|

|40098|成员尚未实名认证|确认传入的userid是已经过实名认证成员的|

|40099|接替成员的外部联系人数量已达上限|-|

|40100|此用户的外部联系人已经在转移流程中|-|

|40102|域名或IP不可与应用市场上架应用重复|-|

|40123|上传临时图片素材，图片格式非法|请确认上传的内容是否为合法的图片内容|

|40124|推广活动里的sn禁止绑定|-|

|40125|无效的openuserid参数|-|

|40126|企业标签个数达到上限，最多为3000个|-|

| 41001 | 缺少access\_token参数 | - |

| 41002 | 缺少corpid参数 | - |

| 41004 | 缺少secret参数 | - |

| 41006 | 缺少media\_id参数 | media\_id为调用接口必填参数，请确认是否有传递 |

| 41008 | 缺少auth code参数 | - |

| 41009 | 缺少userid参数 | - |

| 41010 | 缺少url参数 | - |

| 41011 | 缺少agentid参数 | - |

| 41016 | 缺少title参数 | 发送图文消息，标题是必填参数。请确认参数是否有传递。 |

| 41019 | 缺少 department 参数 | 查看帮助 |

| 41017 | 缺少tagid参数 | - |

| 41021 | 缺少suite\_id参数 | - |

| 41022 | 缺少suite\_access\_token参数 | - |

| 41023 | 缺少suite\_ticket参数 | - |

| 41024 | 缺少secret参数 | - |

| 41025 | 缺少permanent\_code参数 | - |

| 41033 | 缺少 description 参数 | 发送文本卡片消息接口，description 是必填字段 |

| 41035 | 缺少外部联系人userid参数 | - |

| 41036 | 不合法的企业对外简称|企业对外简称必须是认证过的，如果要改回默认简称，传空字符串把对外简称清除就可以了|

|41037|缺少「联系我」type参数|-|

|41038|缺少「联系我」scene参数|-|

|41039|无效的「联系我」type参数|-|

|41040|无效的「联系我」scene参数|-|

|41041|「联系我」使用人数超过限制|默认限制不超过100人(包括部门展开后的人数)|

|41042|无效的「联系我」style参数|-|

|41043|缺少「联系我」config\_id参数|-|

|41044|无效的「联系我」config\_id参数|-|

|41045|API添加「联系我」达到数量上限|-|

|41046|缺少企业群发消息id|-|

|41047|无效的企业群发消息id|-|

|41048|无可发送的客户|-|

|41049|缺少欢迎语code参数|-|

|41050|无效的欢迎语code|欢迎语code(welcome\_code)具有时效性，须在添加好友后20秒内使用|

|41051|客户和服务人员已经开始聊天了|已经开始的聊天的客户不能发送欢迎语|

|41052|无效的发送时间|-|

|41053|客户未同意聊天存档|须外部联系人同意服务须知后，成员才可发送欢迎语|

|41054|该用户尚未激活|-|

|41055|群欢迎语模板数量达到上限|-|

|41056|外部联系人id类型不正确|-|

|41057|企业或服务商未绑定微信开发者账号|-|

| 41102 | 缺少菜单名 | - |

| 42001 | access\_token已过期 | access\_token有时效性，需要重新获取一次 |

| 42007 | pre\_auth\_code已过期 | pre\_auth\_code有时效性，需要重新获取一次 |

| 42009 | suite\_access\_token已过期 | suite\_access\_token有时效性，需要重新获取一次 |

|42012 | jsapi\_ticket不可用，一般是没有正确调用接口来创建jsapi\_ticket| 如果是agentConfig使用，请特别注意是否是使用" 获取应用身份的ticket"来获取jsapi\_ticket|

| 42013 | 小程序未登陆或登录态已经过期 | 需要重新走登陆流程 |

| 42014 | 任务卡片消息的task\_id不合法 | - |

| 42015 | 更新的消息的应用与发送消息的应用不匹配 | - |

| 42016 | 更新的task\_id不存在| - |

| 42017 | 按钮key值不存在| - |

| 42018 | 按钮key值不合法| - |

| 42019 | 缺少按钮key值不合法| - |

| 42020 | 缺少按钮名称| - |

| 42021 | device\_access\_token 过期| - |

| 42022 | code已经被使用过。只能使用一次| - |

| 43004 | 指定的userid未绑定微信或未关注微工作台（原企业号） | 需要成员使用微信登录企业微信或者关注微工作台才能获取openid |

| 43009 | 企业未验证主体|-|

| 44001 | 多媒体文件为空 | 上传格式参考： 上传临时素材，确认header和body的内容正确。|

| 44004 | 文本消息content参数为空 | 发文本消息content为必填参数，且不能为空 |

| 45001 | 多媒体文件大小超过限制 | 图片不可超过5M；音频不可超过5M；文件不可超过20M |

| 45002 | 消息内容大小超过限制 | 查看帮助 |

| 45004 | 应用description参数长度不符合系统限制 | 设置应用若带有description参数，则长度必须为4至120个字符 |

| 45007 | 语音播放时间超过限制 | 语音播放时长不能超过60秒 |

| 45008 | 图文消息的文章数量不符合系统限制 | 图文消息的文章数量不能超过8条 |

| 45009 | 接口调用超过限制 | 查看帮助 |

| 45022 | 应用name参数长度不符合系统限制 | 设置应用若带有name参数，则不允许为空，且不超过32个字符 |

| 45024 | 帐号数量超过上限 | 查看帮助 |

| 45026 | 触发删除用户数的保护 | 限制参考： 全量覆盖成员 |

| 45029 | 回包大小超过上限 | 查看帮助 |

| 45032 | 图文消息author参数长度超过限制 | 最长64个字节 |

| 45033 | 接口并发调用超过限制 | 查看帮助 |

| 45034 | url必须有协议头| 在url前面加上协议头 http:// 或 https:// |

| 46003 | 菜单未设置 | 菜单需发布后才能获取到数据 |

| 46004 | 指定的用户不存在 | 需要确认指定的用户存在于通讯录中 |

| 48002 | API接口无权限调用 | 查看帮助 |

| 48003 | 不合法的suite\_id | 确认suite\_access\_token由指定的suite\_id生成 |

| 48004 | 授权关系无效 | 可能是无授权或授权已被取消 |

| 48005 | API接口已废弃 | 接口已不再支持，建议改用新接口或者新方案 |

| 48006 | 接口权限被收回 | 由于企业长时间未使用应用，接口权限被收回，需企业管理员重新启用 |

| 50001 | redirect\_url未登记可信域名 | 查看帮助 |

| 50002 | 成员不在权限范围 | 请检查应用或管理组的权限范围 |

| 50003 | 应用已禁用 | 查看帮助 |

| 60001 | 部门长度不符合限制 | 部门名称不能为空且长度不能超过32个字 |

| 60003 | 部门ID不存在 | 需要确认部门ID是否有带，并且存在通讯录中 |

| 60004 | 父部门不存在 | 需要确认父亲部门ID是否有带，并且存在通讯录中 |

| 60005 | 部门下存在成员 | 不允许删除有成员的部门 |

| 60006 | 部门下存在子部门 | 不允许删除有子部门的部门 |

| 60007 | 不允许删除根部门 | - |

| 60008 | 部门已存在 | 部门ID或者部门名称已存在 |

| 60009 | 部门名称含有非法字符 | 不能含有 \\:?\\ "\\u003c>| 等字符 |

| 60010 | 部门存在循环关系 | 查看帮助 |

| 60011 | 指定的成员/部门/标签参数无权限 | 查看帮助 |

| 60012 | 不允许删除默认应用 | 默认应用的id为0 |

| 60020 | 访问ip不在白名单之中 | 查看帮助 |

| 60021 | userid不在应用可见范围内 | - |

| 60028 | 不允许修改第三方应用的主页 URL | 第三方应用类型，不允许通过接口修改该应用的主页 URL |

| 60102 | UserID已存在 | - |

| 60103 | 手机号码不合法 | 长度不超过32位，字符仅支持数字，加号和减号 |

| 60104 | 手机号码已存在 | 同一个企业内，成员的手机号不能重复。建议更换手机号，或者更新已有的手机记录。 |

| 60105 | 邮箱不合法 | 长度不超过64位，且为有效的email格式 |

| 60106 | 邮箱已存在 | 同一个企业内，成员的邮箱不能重复。建议更换邮箱，或者更新已有的邮箱记录。 |

| 60107 | 微信号不合法 |微信号格式由字母、数字、"-"、"\\“组成，长度为 3-20 字节，首字符必须是字母或”-“或”\\"|

| 60110 | 用户所属部门数量超过限制 | 用户同时归属部门不超过20个 |

| 60111 | UserID不存在 | UserID参数为空，或者不存在通讯录中 |

| 60112 | 成员name参数不合法 | 不能为空，且不能超过64字符 |

| 60123 | 无效的部门id | 部门不存在通讯录中 |

| 60124 | 无效的父部门id | 父部门不存在通讯录中 |

| 60125 | 非法部门名字 | 不能为空，且不能超过64字节，且不能含有\\:\\?"\\u003c>|等字符 |

| 60127 | 缺少department参数 | - |

| 60129 | 成员手机和邮箱都为空 | 成员手机和邮箱至少有个非空 |

| 60132 | is\_leader\_in\_dept和department的元素个数不一致| - |

| 60136 | 记录不存在| - |

| 60137 | 家长手机号重复 |同一个家校通讯录中，家长的手机号不能重复。建议更换手机号，或者更新已有的手机记录。 |

|60203|不合法的模版ID|-|

|60204|模版状态不可用|-|

|60205|模版关键词不匹配|-|

|60206|该种类型的消息只支持第三方独立应用使用|-|

|60207|第三方独立应用只允许发送模板消息|-|

|60208|第三方独立应用不支持指定@all，不支持参数toparty和totag|-|

|65000|学校已经迁移|-|

|65001|无效的关注模式|-|

|65002|导入家长信息数量过多|批量导入家长每次最多1000个|

|65003|学校尚未迁移|-|

|65004|组织架构不存在|-|

|65005|无效的同步模式|-|

|65006|无效的管理员类型|-|

|65007|无效的家校部门类型|-|

|65008|无效的入学年份|-|

|65009|无效的标准年级类型|-|

|65010|此userid并不是学生|-|

|65011|家长userid数量超过限制|每次最多批量处理100个家长|

|65012|学生userid数量超过限制|每次最多批量处理10个学生|

|65013|学生已有家长|-|

|65014|非学校企业|-|

|65015|父部门类型不匹配|添加学校部门，需满足层级关机，班级需要以年级为父部门|

| 72023 | 发票已被其他公众号锁定 | 查看帮助 |

| 72024 | 发票状态错误 | reimburse\_status状态错误，参考： 更新发票状态 |

| 72037 | 存在发票不属于该用户 | 只能批量更新该openid的发票，参考： 批量更新发票状态 |

| 80001 | 可信域名不正确，或者无ICP备案 | 查看帮助 |

| 81001 | 部门下的结点数超过限制（3W） | - |

| 81002 | 部门最多15层 | - |

| 81003 | 标签下节点个数超过30000个|-|

| 81011 | 无权限操作标签 | 查看帮助 |

| 81012 | 缺失可见范围 | 请求没有填写UserID、部门ID、标签ID |

| 81013 | UserID、部门ID、标签ID全部非法或无权限 | 查看帮助 |

| 81014 | 标签添加成员，单次添加user或party过多 | - |

| 81015 | 邮箱域名需要跟企业邮箱域名一致 | - |

| 81016 | logined\_userid字段缺失 | - |

| 81017 | items字段大小超过限制（20） | - |

| 81018 | 该服务商可获取名字数量配额不足 | - |

| 81019 | items数组成员缺少id字段 | - |

| 81020 | items数组成员缺少type字段 | - |

| 81021 | items数组成员的type字段不合法 | - |

| 82001 | 指定的成员/部门/标签全部为空 | 查看帮助 |

| 82002 | 不合法的PartyID列表长度 | 发消息，单次不能超过100个部门 |

| 82003 | 不合法的TagID列表长度 | 发消息，单次不能超过100个标签 |

| 84014 | 成员票据过期 | 查看帮助 |

| 84015 | 成员票据无效 | 确认user\_ticket参数来源是否正确。参考接口： 根据code获取成员信息 |

| 84019 | 缺少templateid参数 |-|

| 84020 | templateid不存在 | 确认参数是否有带，并且已创建 |

| 84021 | 缺少register\_code参数 | - |

| 84022 | 无效的register\_code参数 | - |

| 84023 | 不允许调用设置通讯录同步完成接口 | - |

| 84024 | 无注册信息 | 查看帮助|

| 84025 | 不符合的state参数| 必须是\[a-zA-Z0-9\]的参数值，长度不可超过128个字节 |

| 84052 | 缺少caller参数| - |

| 84053 | 缺少callee参数| - |

| 84054 | 缺少auth\_corpid参数| - |

| 84055 | 超过拨打公费电话频率| 同一个客服5秒内只能调用api拨打一次公费电话|

| 84056 | 被拨打用户安装应用时未授权拨打公费电话权限| - |

| 84057 | 公费电话余额不足| - |

| 84058 | caller 呼叫号码不支持| - |

| 84059 | 号码非法| - |

| 84060 | callee 呼叫号码不支持| - |

| 84061 | 不存在外部联系人的关系| - |

| 84062 | 未开启公费电话应用| - |

| 84063 | caller不存在| - |

| 84064 | callee不存在| - |

| 84065 | caller跟callee电话号码一致| 不允许自己拨打给自己 |

| 84066 | 服务商拨打次数超过限制| 单个企业管理员，在一天（以上午10:00为起始时间）内，对应单个服务商，只能被呼叫【4】次。 |

| 84067 | 管理员收到的服务商公费电话个数超过限制| 单个企业管理员，在一天（以上午10:00为起始时间）内，一共只能被【3】个服务商成功呼叫。 |

| 84069 | 拨打方被限制拨打公费电话| -|

| 84070 | 不支持的电话号码| 拨打方或者被拨打方电话号码不支持|

| 84071 | 不合法的外部联系人授权码| 非法或者已经消费过|

| 84072 | 应用未配置客服| -|

| 84073 | 客服userid不在应用配置的客服列表中| -|

| 84074 | 没有外部联系人权限| -|

|84075|不合法或过期的authcode|-|

|84076|缺失authcode|-|

|84077|订单价格过高，无法受理|-|

|84078|购买人数不正确|-|

|84079|价格策略不存在|-|

|84080|订单不存在|-|

|84081|存在未支付订单|-|

|84082|存在申请退款中的订单|-|

|84083|非服务人员|-|

|84084|非跟进用户|-|

|84085|应用已下架|-|

|84086|订单人数超过可购买最大人数|-|

|84087|打开订单支付前禁止关闭订单|-|

|84088|禁止关闭已支付的订单|-|

|84089|订单已支付|-|

|84090|缺失user\_ticket|-|

|84091|订单价格不可低于下限|-|

|84092|无法发起代下单操作|-|

|84093|代理关系已占用，无法代下单|-|

|84094|该应用未配置代理分润规则，请先联系应用服务商处理|-|

|84095|免费试用版，无法扩容|-|

|84096|免费试用版，无法续期|-|

|84097|当前企业有未处理订单|-|

|84098|固定总量，无法扩容|-|

|84099|非购买状态，无法扩容|-|

|84100|未购买过此应用，无法续期|-|

|84101|企业已试用付费版本，无法全新购买|-|

|84102|企业当前应用状态已过期，无法扩容|-|

|84103|仅可修改未支付订单|-|

|84104|订单已支付，无法修改|-|

|84105|订单已被取消，无法修改|-|

|84106|企业含有该应用的待支付订单，无法代下单|-|

|84107|企业含有该应用的退款中订单，无法代下单|-|

|84108|企业含有该应用的待生效订单，无法代下单|-|

|84109|订单定价不能未0|-|

|84110|新安装应用不在试用状态，无法升级为付费版|-|

|84111|无足够可用优惠券|-|

|84112|无法关闭未支付订单|-|

|84113|无付费信息|-|

|84114|虚拟版本不支持下单|-|

|84115|虚拟版本不支持扩容|-|

|84116|虚拟版本不支持续期|-|

|84117|在虚拟正式版期内不能扩容|-|

|84118|虚拟正式版期内不能变更版本|-|

|84119|当前企业未报备，无法进行代下单|-|

|84120|当前应用版本已删除|-|

|84121|应用版本已删除，无法扩容|-|

|84122|应用版本已删除，无法续期|-|

|84123|非虚拟版本，无法升级|-|

|84124|非行业方案订单，不能添加部分应用版本的订单|-|

|84125|购买人数不能少于最少购买人数|-|

|84126|购买人数不能多于最大购买人数|-|

|84127|无应用管理权限|-|

|84128|无该行业方案下全部应用的管理权限|-|

|84129|付费策略已被删除，无法下单|-|

|84130|订单生效时间不合法|-|

| 84200 | 文件转译解析错误| 只支持utf8文件转译，可能是不支持的文件类型或者格式|

| 85002 | 包含不合法的词语 | - |

| 85004 | 每企业每个月设置的可信域名不可超过20个 | - |

| 85005 | 可信域名未通过所有权校验 | 查看帮助|

| 86001 | 参数 chatid 不合法 | - |

| 86003 | 参数 chatid 不存在 | - |

| 86004 | 参数 群名不合法 | - |

| 86005 | 参数 群主不合法 | - |

| 86006 | 群成员数过多或过少 | - |

| 86007 | 不合法的群成员 | - |

| 86008 | 非法操作非自己创建的群 | - |

| 86101 | 仅群主才有操作权限 | - |

| 86201 | 参数 需要chatid | - |

| 86202 | 参数 需要群名 | - |

| 86203 | 参数 需要群主 | - |

| 86204 | 参数 需要群成员 | - |

| 86205 | 参数 字符串chatid过长 | - |

| 86206 | 参数 数字chatid过大 | - |

| 86207 | 群主不在群成员列表 | - |

| 86215 | 会话ID已经存在 | - |

| 86216 | 存在非法会话成员ID | 查看帮助|

| 86217 | 会话发送者不在会话成员列表中 | 会话的发送者，必须是会话的成员列表之一 |

| 86220 | 指定的会话参数不合法 | 查看帮助|

| 86224 | 不是受限群，不允许使用该接口 | - |

|90001|未认证摇一摇周边|-|

| 90002 | 缺少摇一摇周边ticket参数 | - |

| 90003 | 摇一摇周边ticket参数不合法 | - |

|90100| 非法的对外属性类型| - |

|90101|对外属性：文本类型长度不合法| 文本长度不可超过12个UTF8字符|

|90102|对外属性：网页类型标题长度不合法| 标题长度不可超过12个UTF8字符 |

|90103|对外属性：网页url不合法| - |

|90104|对外属性：小程序类型标题长度不合法|标题长度不可超过12个UTF8字符|

|90105|对外属性：小程序类型pagepath不合法|-|

|90106|对外属性：请求参数不合法|-|

|90200|缺少小程序appid参数| - |

|90201|小程序通知的content\_item个数超过限制| item个数不能超过10个 |

|90202|小程序通知中的key长度不合法| 不能为空或超过10个汉字|

|90203|小程序通知中的value长度不合法| 不能为空或超过30个汉字|

|90204|小程序通知中的page参数不合法| - |

|90206| 小程序未关联到企业中| -|

|90207| 不合法的小程序appid| - |

|90208| 小程序appid不匹配|-|

|90300| orderid 不合法|-|

|90302| 付费应用已过期|-|

|90303| 付费应用超过最大使用人数|-|

|90304| 订单中心服务异常，请稍后重试|-|

|90305| 参数错误，errmsg中有提示具体哪个参数有问题|-|

|90306| 商户设置不合法，详情请见errmsg|-|

|90307| 登录态过期|-|

|90308| 在开启IP鉴权的前提下，识别为无效的请求IP|-|

|90309| 订单已经存在，请勿重复下单|-|

|90310| 找不到订单|-|

|90311| 关单失败, 可能原因：该单并没被拉起支付页面; 已经关单；已经支付；渠道失败；单处于保护状态；等等|-|

|90312| 退款请求失败, 详情请看errmsg|-|

|90313| 退款调用频率限制，超过规定的阈值|-|

|90314| 订单状态错误，可能未支付，或者当前状态操作受限|-|

|90315| 退款请求失败，主键冲突，请核实退款refund\_id是否已使用|-|

|90316| 退款原因编号不对|-|

|90317| 尚未注册成为供应商|-|

|90318| 参数nonce\_str 为空或者重复，判定为重放攻击|-|

|90319| 时间戳为空或者与系统时间间隔太大|-|

|90320| 订单token无效|-|

|90321| 订单token已过有效时间|-|

|90322| 旧套件（包含多个应用的套件）不支持支付系统|-|

|90323| 单价超过限额|-|

|90324| 商品数量超过限额|-|

|90325| 预支单已经存在|-|

|90326| 预支单单号非法|-|

|90327| 该预支单已经结算下单|-|

|90328| 结算下单失败，详情请看errmsg|-|

|90329| 该订单号已经被预支单占用|-|

|90330| 创建供应商失败|-|

|90331| 更新供应商失败|-|

|90332| 还没签署合同|-|

|90333| 创建合同失败|-|

|90338| 已经过了可退款期限|-|

|90339| 供应商主体名包含非法字符|-|

|90340| 创建客户失败，可能信息真实性校验失败|-|

|90341| 退款金额大于付款金额|-|

|90342| 退款金额超过账户余额|-|

|90343| 退款单号已经存在|-|

|90344| 指定的付款渠道无效|-|

|90345| 超过5w人民币不可指定微信支付渠道|-|

|90346| 同一单的退款次数超过限制|-|

|90347| 退款金额不可为0|-|

|90348| 管理端没配置支付密钥|-|

|90349| 记录数量太大|-|

|90350| 银行信息真实性校验失败|-|

|90351| 应用状态异常|-|

|90352| 延迟试用期天数超过限制|-|

|90353| 预支单列表不可为空|-|

|90354| 预支单列表数量超过限制|-|

|90355| 关联有退款预支单，不可删除|-|

|90356| 不能0金额下单|-|

|90357| 代下单必须指定支付渠道 |-|

|90358| 预支单或代下单，不支持部分退款 |-|

|90359| 预支单与下单者企业不匹配 |-|

|90456| 必须指定组织者 |-|

|90457| 日历ID异常 |-|

|90458| 日历ID列表不能为空 |-|

|90459| 日历已删除 |-|

|90460| 日程已删除 |-|

|90461| 日程ID异常 |-|

|90462| 日程ID列表不能为空 |-|

|90463| 不能变更组织者 |-|

|90464| 参与者数量超过限制 |-|

|90465| 不支持的重复类型 |-|

|90466| 不能操作别的应用创建的日历/日程 |-|

|90467| 星期参数异常 |-|

|90468| 不能变更组织者 |-|

|90469| 每页大小超过限制 |-|

|90470| 页数异常 |-|

|90471| 提醒时间异常 |-|

|90472| 没有日历/日程操作权限 |-|

|90473| 颜色参数异常 |-|

|90474| 组织者不能与参与者重叠 |-|

|90475| 不是组织者的日历 |-|

|90500| 群主并未离职 |-|

|90501| 该群不是客户群 |-|

|90502| 群主已经离职 |-|

|90503| 满人 & 99个微信成员，没办法踢，要客户端确认 |-|

|90504| 群主没变 |-|

|90507| 离职群正在继承处理中 |-|

|90508| 离职群已经继承 |-|

| 91040 | 获取ticket的类型无效 | 查看帮助|

|92000| 成员不在应用可见范围之内 |-|

|92001| 应用没有敏感信息权限 |-|

|92002| 不允许跨企业调用 |-|

| 93000 | 机器人webhookurl不合法或者机器人已经被移除出群|-|

| 93004 | 机器人被停用|-|

|93008|不在群里|-|

|94000|应用未开启工作台自定义模式|请在管理端后台应用详情里面开启自定义工作台模式|

|94001|不合法的type类型|-|

|94002|缺少keydata字段|-|

|94003|keydata的items列表长度超出限制|-|

|94005|缺少list字段|-|

|94006|list的items列表长度超出限制|-|

|94007|缺少webview字段|-|

|94008|应用未设置自定义工作台模版类型|-|

| 301002 | 无权限操作指定的应用 | 查看帮助 |

| 301005 | 不允许删除创建者 | 创建者不允许从通讯录中删除。如果需要删除该成员，需要先在WEB管理端转移创建者身份。|

| 301012 | 参数 position 不合法 | 长度不允许超过128个字符 |

| 301013 | 参数 telephone 不合法 | telephone必须由1-32位的纯数字或’-'号组成。 |

| 301014 | 参数 english\_name 不合法 | 参数如果有传递，不允许为空字符串，同时不能超过64字节，只能是由字母、数字、点(.)、减号(-)、空格或下划线(\\\_)组成 |

| 301015 | 参数 mediaid 不合法 | 请检查 mediaid 来源，应该通过 上传临时素材的图片类型获得mediaid |

| 301016 | 上传语音文件不符合系统要求 | 语音文件的系统限制，参考 上传的媒体文件限制 |

| 301017 | 上传语音文件仅支持AMR格式 | 语音文件的系统限制，参考 上传的媒体文件限制 |

| 301021 | 参数 userid 无效 | 至少有一个userid不存在于通讯录中 |

| 301022 | 获取打卡数据失败 | 系统失败，可重试处理 |

| 301023 | useridlist非法或超过限额 | 列表数量不能为0且不超过100 |

| 301024 | 获取打卡记录时间间隔超限 | 保证开始时间大于0 且结束时间大于 0 且结束时间大于开始时间，且间隔少于一个月 |

| 301025 | 审批开放接口参数错误 | 请参考参数说明正确填写 |

| 301036 | 不允许更新该用户的userid | 查看帮助|

| 302003 | 批量导入任务的文件中userid有重复 | - |

| 302004 | 组织架构不合法（1不是一棵树，2 多个一样的partyid，3 partyid空，4 partyid name 空，5 同一个父节点下有两个子节点 部门名字一样 可能是以上情况，请一一排查） | - |

| 302005 | 批量导入系统失败，请重新尝试导入 | - |

| 302006 | 批量导入任务的文件中partyid有重复 | - |

| 302007 | 批量导入任务的文件中，同一个部门下有两个子部门名字一样 | - |

| 2000002 | CorpId参数无效 | 指定的CorpId不存在 |

|600001|不合法的sn|sn可能尚未进行登记|

|600002|设备已注册|可能设备已经建立过长连接|

|600003|不合法的硬件activecode|-|

|600004|该硬件尚未授权任何企业|-|

|600005|硬件Secret无效|-|

|600007|缺少硬件sn|-|

|600008|缺少nonce参数|-|

|600009|缺少timestamp参数|-|

|600010|缺少signature参数|-|

|600011|签名校验失败|-|

|600012|长连接已经注册过设备|-|

|600013|缺少activecode参数|-|

|600014|设备未网络注册|-|

|600015|缺少secret参数|-|

|600016|设备未激活|-|

|600018|无效的起始结束时间|-|

|600020|设备未登录|-|

|600021|设备sn已存在|-|

|600023|时间戳已失效|-|

|600024|固件大小超过5M|-|

|600025|固件名为空或者超过20字节|-|

|600026|固件信息不存在|-|

|600027|非法的固件参数|-|

|600028|固件版本已存在|-|

|600029|非法的固件版本|-|

|600030|缺少固件版本参数|-|

|600031|硬件固件不允许升级|-|

|600032|无法解析硬件二维码|-|

|600033|设备型号id冲突|-|

|600034|指纹数据大小超过限制|-|

|600035|人脸数据大小超过限制|-|

|600036|设备sn冲突|-|

|600037|缺失设备型号id|-|

|600038|设备型号不存在|-|

|600039|不支持的设备类型|-|

|600040|打印任务id不存在|-|

|600041|无效的offset或limit参数值|-|

|600042|无效的设备型号id|-|

|600043|门禁规则未设置|-|

|600044|门禁规则不合法|-|

|600045|设备已订阅企业信息|-|

|600046|操作id和用户userid不匹配|-|

|600047|secretno的status非法|请确认是否是使用统一初始secretno的设备，如果是无有正确执行换secretno的流程|

|600048|无效的指纹算法|-|

|600049|无效的人脸识别算法|-|

|600050|无效的算法长度|-|

|600051|设备过期|-|

|600052|无效的文件分块|-|

|600053|该链接已经激活|-|

|600054|该链接已经订阅|-|

|600055|无效的用户类型|-|

|600056|无效的健康状态|-|

|600057|缺少体温参数|-|

|610001|永久二维码超过每个员工5000的限制|-|

|610003|scene参数不合法|有效的scene长度为1~64字符，由英文字母、数字、中划线、下划线以及点号构成|

|610004|userid不在客户联系配置的使用范围内|请在管理端后台 客户联系->配置->配置使用范围配置该用户|

排查方法

错误码：40003

不合法的UserID。确认：

1）有效的UserID需要满足：长度1~64字符，由英文字母、数字、中划线、下划线以及点号构成。

2）除了创建用户，其余使用UserID的接口，还要保证UserID必须在通讯录中存在。

错误码：40007

不合法的媒体文件。确认：

1）媒体文件ID的获取方式，是否存在。注：上传临时素材生成的medida\_id，有效期是3天。

2）媒体文件类型应符合接口要求（比如发送图片消息，此时不能用音频文件的media\_id）。

错误码：40014

access\_token参数错误。确认：

1）access\_token的获取方式

2）access\_token是否已过期

可以重新获取一次access\_token解决

错误码：40029

oauth\_code参数错误。确认：

1）code只能消费一次，不能重复消费。比如说，是否存在多个服务器同时消费同一code情况。

2）code需要在有效期间消费（5分钟），过期会自动失效。

错误码：40032

不合法的UserID列表长度。确认：

1）发消息接口，最多指定1000人。

2）批量删除成员接口，最多指定200人。

错误码：40035

不合法的参数。确认：

1）userlist和partylist不能同时为空

2）userlist包含的成员个数不能大于1000

3）partylist包含的部门个数不能大于100

4）指定的userlist和partylist为数组格式，不是字符串格式。比如说， “userlist”:\[ “user1”,“user2”\]，而不是 “userlist”: “user1|user2”

错误码：40054 40055

菜单设置URL不合法。确认：

1）链接需要带上协议头。以 http:// 或者 https:// 开头。比如：[https://work.weixin.qq.com][https_work.weixin.qq.com]

2）微信支付的链接，必须以 weixin://wxpay/bizpayurl 开头

错误码：40056

agentid不合法。确认：

1）agentid为整型数字

2）在web管理端存在该应用

错误码：40063

必填的参数缺少，需要参照具体API接口说明。同时确认：

1）Http请求方法，是否正确。比如说接口要求以Post方法，就不能使用Get方式

2）Http请求参数，是否正确。比如说，接口内容要求json结构体，就不能以url参数传递或者form-data方式。

错误码：40070

指定的标签范围结点全部无效。确认：

1）指定的参数格式是否正确。比如，“userlist”:\[ “user1”\]，而不是指定为 “userlist” : “user1”。

2）指定的成员或者部门，是否存在于通讯录中。

错误码：40082

suite\_token参数错误。确认：

1）suite\_token的获取方式

2）suite\_token是否已过期

可以重新获取一次suite\_token解决

错误码：40084

不合法的永久授权码。确认：

1）是否填写有误

2）企业是否已取消授权该套件

3）永久授权码不能跨服务商使用

错误码：40092

导入文件存在不合法的内容。确认：

1）不允许上传空文件

2）文件内容缺少必填字段，比如：手机/邮箱，姓名，UserID或者部门。

错误码：41019

缺少 department 参数。确认：

1）创建成员接口，成员所属部门是必填信息。

2）所属部门是数字数组格式，不是字符串。如："department: \[1, 2\]

错误码：45002

消息内容大小超过限制。确认：

1）文本消息类型：最长不超过2048个字节。

2）图文消息类型：最长不超过666k个字节

错误码：45009

接口调用超过限制。

具体频率策略，参考：主动调用频率限制

频率拦截时长一般与调用的限制时长相同，比如说是分钟级别的限制，则在中频率后的1分钟后自动解除。小时、天、以及月份，也是以此类推。

我们对接口调用的频率限制是比较宽松的。对于接口中频率的调用，考虑以下优化：

\- 接口实现时，仅系统失败需要重试。其余错误码，应该排查下调用失败原因

\- 发消息应该控制合理调用，对于单个成员来说，一天收到大量的推送，体验是不好的

4) 部分频率拦截，可自助解封，访问：频率自助解封工具

5) 发送应用消息的频率拦截，可用api接口查询各个应用消息发送统计，访问：查询应用消息发送统计

错误码：45033

接口并发调用超过限制。出现这种拦截限制，一般是开发者的程序有bug，导致对同一份资源有过高的并发且持续不断的请求，例如对一个media\_id一直持续不断请求“获取临时素材”接口。

错误码：45024

帐号数量超过上限。请确认：

1）通讯录是否有无效或者无用的帐号，可以删除，让出额度

2）提高帐号上限，可以提交重新认证或者申请扩容

错误码：45028

素材数量超过上限。请确认：

1）图片和图文素材上限各为5000个。

2）其他类型的素材的上限各为1000个。

错误码：45029

回包大小超过上限。请确认：

1）/cgi-bin/user/list：由于通讯录组织架构庞大，建议按部门分别拉取，同时不要指定fetch\_child=1。

错误码：48002

API接口无权限调用。请确认：

1）写通讯录接口，只能由通讯录同步助手的access\_token来调用。同时需要保证通讯录同步功能是开启的。

2）通讯录同步助手的access\_token，仅用于同步通讯录，不能用于发消息

3）设置应用可见范围，仅支持注册定制化安装情况，详情见：设置授权应用可见范围

4）客户联系相关的接口，只能由系统应用“客户联系”，或配置到“可调用应用”列表中的自建应用的access\_token来调用。

5) 小程序应用仅支持发送小程序通知消息，暂不支持文本、图片、语音、视频、图文等其他类型的消息。

错误码：50001

redirect\_url未登记可信域名。请确认：

1）颁发code的场景在哪个应用点击的。消费code使用的access\_token是否有该应用权限。（通过查询access\_token权限可确认）

2）secret的获取来源

\- 来源于应用：url的域名，需设置到应用可信域名中。

\- 来源于通讯录同步助手：仅可同步通讯录，不可用于发消息或者消费code

\- 来源于第三方套件授权：套件中至少有一个应用，设置了该url域名为可信域名

\- 来源于管理组：管理组配置的应用列表，至少有一个应用设置了该url域名为可信域名

3）url填写的域名，必须与设置的可信域名 完全匹配（包括端口号）。比如：填可信域名填[qq.com][]，访问url域名为[www.qq.com][]，就不匹配；或者可信域名填[www.qq.com][]，访问url域名为[www.qq.com:8008][www.qq.com_8008]，也不匹配。

错误码：50003

应用禁用之后，将无法再调用api，可在"管理端-应用管理"重新启用该应用。

\\u003cimg src=“[https://p.qpic.cn/pic\_wework/1283325914/090fad19ebf740ce78b1e49f2cc0f0f8d1791c3262b8e946/0][https_p.qpic.cn_pic_wework_1283325914_090fad19ebf740ce78b1e49f2cc0f0f8d1791c3262b8e946_0]” style=“width:800px;”/>

错误码：60010

部门存在循环关系。请确认：

1）创建部门和更新部门时，指定的parentid参数不能是 部门id 或者 子部门id

错误码：60011

指定的成员/部门/标签参数无权限。请确认：

变更通讯录接口，需要有通讯录编辑权限。

普通应用的secret仅有只读权限，可使用通讯录同步助手的secret同步。

其它接口，需要满足配置的通讯录范围。

成员：通讯录同步助手access\_token可指定任意成员id；应用access\_token仅能指定可见范围配置的成员，以及部门/标签包含的成员（递归展开）

部门：通讯录同步助手access\_token可指定任意部门id；应用access\_token仅能指定可见范围配置的部门id(创建或移动部门，还需要具有父部门的管理权限)，标签包括的部门id，以及上述部门的子部门id

标签：通讯录同步助手access\_token可指定超级管理组及通讯录同步助手创建的标签；应用access\_token仅能由应用API创建的标签

错误码：60020

访问ip不在白名单之中。请确认：

1）请确认访问ip是否在服务商白名单IP列表。

错误码：72023

一般为发票已进入后续报销流程，报销企业公众号/企业微信/App锁定了发票。

错误码：80001

可信域名不正确，未校验域名所有权归属或者可信域名没有ICP备案。请确认：

1）可信域名，只支持全域名匹配，无法通过配置父域来让所有子域都成为可信域名。

2）可信域名，不支持IP地址、端口号及短链域名。

3）如果确认域名已经通过ICP备案，但依然提示这个错误，请尝试重新设置。

错误码：81011

无权限操作标签。请确认：

1）除了通讯录同步助手和通讯录应用，其他应用和管理组都只能操作自己创建的标签。

2）通讯录同步助手或者通讯录应用，除了能管理自己的标签，还能操作超级管理组创建的标签。

错误码：81013

UserID、部门ID、标签ID全部非法或无权限。一般有以下两种原因：

1）成员、部门或标签已被删除，此种情况需要调整调用接口的接收人参数。

2）成员、部门或标签被移出应用的可见范围，可在管理端将接收人添加到应用的可见范围内。

\\u003cimg src=“[https://p.qpic.cn/pic\_wework/1283325914/4e48eb5ea14e98977a1687c6cceab0d61ad57eea9af062f0/0][https_p.qpic.cn_pic_wework_1283325914_4e48eb5ea14e98977a1687c6cceab0d61ad57eea9af062f0_0]” style=“width:800px;”/>

错误码：82001

指定的成员/部门/标签全部为空。请确认：

参数是否有传递，且至少有一个参数非空。

错误码：84014

成员票据过期。确认：

1）user\_ticket 有时效性，有效时长由expires\_in指定。参考接口：根据code获取成员信息

2）若需再次获取用户详情，需要用户重新点击链接后，根据新的code获取新的user\_ticket

错误码：84024

无注册信息。可能是以下两种情况：

1）注册流程未完成。

2）注册成功已超过24小时。

错误码：85005

域名未通过所有权校验，仅oauth2生效，jssdk功能将受限，请根据调用者身份按以下不同方式完成校验：

1）若调用者是企业应用，请登录企业微信管理端，进入应用详情，按照指引完成域名的所有权校验。

2）若调用者是第三方服务，请登录企业微信服务管理端，进入第三方应用详情，按照指引完成域名的所有权校验。

错误码：86216

存在非法会话成员ID。确认：

1）添加会话成员时，指定的成员ID不存在通讯录

2）删除会话成员时，指定的成员ID不存在于会话中

错误码：86220

指定的会话参数不合法。请确认：

1）参数 type 只能指定 single/group

2）参数 msgtype 只能指定 text/image/file/voice/link

错误码：91040

获取ticket的类型无效。jsapi ticket可以通过以下几种获取：

1）获取jsapi\_ticket。这里参数只需要传access\_token，不需要带其余的参数，比如type=jsapi

2）获取电子发票ticket。需要同时指定access\_token及type，同时type=wx\_card是固定的。

错误码：301002

无权限操作指定的应用。access\_token来源需要有指定应用的权限。

比如说，发消息接口 指定了参数 “agentid”: 14，但使用的 access\_token 是通过应用agentid: 100032 生成的调用凭证，这种就会报该错误码。

access\_token的权限查询，可在 错误码查询工具 确认。

错误码：301036

不允许更新该用户的userid。确认：

只有当userid由系统自动生成时，才被允许修改一次

比如，邀请关注时用户提交登记信息，审批通过后系统会自动分配userid，此时可修改userid

[https_work.weixin.qq.com]: https://work.weixin.qq.com
[qq.com]: https://qq.com
[www.qq.com]: https://www.qq.com
[www.qq.com_8008]: https://www.qq.com:8008
[https_p.qpic.cn_pic_wework_1283325914_090fad19ebf740ce78b1e49f2cc0f0f8d1791c3262b8e946_0]: https://p.qpic.cn/pic_wework/1283325914/090fad19ebf740ce78b1e49f2cc0f0f8d1791c3262b8e946/0
[https_p.qpic.cn_pic_wework_1283325914_4e48eb5ea14e98977a1687c6cceab0d61ad57eea9af062f0_0]: https://p.qpic.cn/pic_wework/1283325914/4e48eb5ea14e98977a1687c6cceab0d61ad57eea9af062f0/0