错误码
每次调用接口时，可以获得正确或错误的返回码。可根据返回码信息调试接口，排查错误。
注意应用程序可根据errcode来判断出错的情况，不要依赖errmsg来匹配，因为errmsg可能会调整。
错误码格式说明
errcode = 0，表示正常返回。示例：
{ "errcode":0, "errmsg":"ok", “data”：{ "expires_in":7200, "access_token":"1cc1bb3xxxx" } }errcode为其他值，表示请求失败，需要关注下返回结果里的errmsg。示例：
{ "errcode":100001, "errmsg":"IP白名单信息未设置" }
全局返回码
| 参数 | 参考 | 原因 | 排查方法 |
|---|---|---|---|
| 200 | {“errcode”:200,”errmsg”:”同步成功”} | 客户方回发给云客服的工单流出响应码 | 客户方登录云客服设置工单流出URL后，后经云客服工单流程处理，将工作流节点信息发送给客户方后，客户方回发给云客服的工单流出响应码； |
| 0 | {“errcode”:0,”errmsg”:”请求成功”} | 请求成功 | 接口调用成功。 |
| 100001 | {“errcode”:100001,”errmsg”:”IP白名单信息未设置”} | IP白名单信息未设置 | 未在优音云客服系统开发者中心添加IP白名单信息。 |
| 100002 | {“errcode”:100002,”errmsg”:”IP鉴权失败”} | IP鉴权失败 | 优音云客服系统开发者中心未设置该IP的白名单信息。 |
| 100003 | {“errcode”:100003,”errmsg”:”tenant_id鉴权失败”} | tenant_id鉴权失败 | 非优音云客服系统的租户。 |
| 100004 | {“errcode”:100004,”errmsg”:”secret未设置”} | secret未设置 | 未在云客服系统开发者中心添加secret信息。 |
| 100005 | {“errcode”:100005,”errmsg”:”secret错误”} | secret错误 | secret信息与服务器不相符。 |
| 100006 | {“errcode”:100006,”errmsg”:”无接口调用权限”} | 无接口调用权限 | 未在云客服系统开发者中心设置接口调用权限。 |
| 100007 | {“errcode”:100007,”errmsg”:”接口调用超过限制”} | 接口调用超过限制 | 接口调用频次超过限制。 |
| 100008 | {“errcode”:100008,”errmsg”:”access_token失效”} | access_token失效 | access_token已失效，需要重新获取。 |
| 100009 | {“errcode”:100009,”errmsg”:”应用已停用”} | 应用已停用 | 未开通优音云客服服务。 |
| 100010 | {“errcode”:100010,”errmsg”:”access_token错误”} | access_token错误 | access_token与服务器不相符。 |
| 100011 | {“errcode”:100011,”errmsg”:”secret不能为空”} | secret不能为空 | 检查secret字段，不能为空。 |
| 100012 | {“errcode”:100012,”errmsg”:”请求参数不完整”} | 请求参数不完整 | 请检查请求参数，请求参数不完整。 |
| 100013 | {“errcode”:100013,”errmsg”:”租户ID不能为空”} | 租户ID不能为空 | 检查租户ID字段，不能为空。 |
| 100014 | {“errcode”:100014,”errmsg”:”该请求不合法”} | 该请求不合法 | 请求中未设置tenant_id、access_token参数。 |
| 100015 | {“errcode”:100015,”errmsg”:”access_token未设置”} | access_token未设置 | 请求未设置access_token参数。 |
| 100016 | {“errcode”:100016,”errmsg”:”系统未找到IP白名单设置”} | 系统未找到IP白名单设置 | 在云客服系统，设置>开发者中心>IP白名单进行添加； |
| 100021 | {“errcode”: 100021,”errmsg”: “请求参数page或size异常，参数非空且须大于0”} | 请求参数中page或size不正确 | 填写大于0的正整数。 |
| 110001 | {“errcode”:110001,”errmsg”:”工作流模板ID不能为空”} | 工作流模板ID不能为空 | 检查工作流模板ID是否有效。 |
| 110002 | {“errcode”:110002,”errmsg”:”工作流信息无效”} | 工作流信息无效 | 检查工作流模板ID是否有效。 |
| 110003 | {“errcode”:110003,”errmsg”:”工单流任务不存在”} | 工单流任务不存在 | 检查工单流任务ID在流转工单接口中是否已使用过或工作流任务ID无效。 |
| 110004 | {“errcode”:110004,”errmsg”:”已挂起任务不能操作”} | 已挂起任务不能操作 | 检查当前工单流转中状态是否是已挂起状态。 |
| 110005 | {“errcode”:110005,”errmsg”:”工作流模板名称不能为空”} | 工作流模板名称不能为空 | 检查请求工单流模板名称参数是否为空。 |
| 110006 | {“errcode”:110006,”errmsg”:”xxxval参数不能为空”} | 具体某表单元素val参数不能为空 | 检查表单元素的val参数是否为空。(若表单多个元素都有异常，则多个错误提示以英文逗号分割并拼接在一行进行提示) |
| 110007 | {“errcode”:110007,”errmsg”:”创建工单异常”} | 创建工单异常 | 请联系云客服客户人员咨询。 |
| 110008 | {“errcode”:110008,”errmsg”:”流转工单异常”} | 流转工单异常 | 请联系云客服客户人员咨询。 |
| 110009 | {“errcode”:110009,”errmsg”:”流转工单异常”} | 流程实例ID不能为空 | 请核流程实例ID是否已传值。 |
| 110010 | {“errcode”:110010,”errmsg”:”流程实例ID无效”} | 流程实例ID无效 | 检查流程实例ID是否有效。 |
| 110011 | {“errcode”:110011,”errmsg”:”租户信息不存在”} | 租户信息不存在 | 检查租户ID是否有效。 |
| 110012 | {“errcode”:110012,”errmsg”:”坐席工号不能为空”} | 坐席工号不能为空 | 检查坐席工号参数是否有值。 |
| 110013 | {“errcode”:110013,”errmsg”:”坐席工号无效”} | 坐席工号无效 | 检查坐席工号是否有效。 |
| 110014 | {“errcode”:110014,”errmsg”:”下步处理人工号无效”} | 下步处理人工号无效 | 检查租户的下步处理人工号是否有效。 |
| 110015 | {“errcode”:110015,”errmsg”:”客户名称和手机号不能同时为空”} | 客户名称和手机号不能都为空 | 检查客户名称和手机号是否同时为空。 |
| 110016 | {“errcode”:110016,”errmsg”:”客户创建失败”} | 客户创建失败 | 请联系云客服客户人员咨询。 |
| 110017 | {“errcode”:110017,”errmsg”:”租户所属客户不存在”} | 租户所属客户不存在 | 检查客户ID传值是否有效。 |
| 110018 | {“errcode”:110018,”errmsg”:”工单activityType参数不能为空”} | 工单activityType参数不能为空 | 检查工单activityType参数是否已传值。 |
| 110019 | {“errcode”:110019,”errmsg”:”工单activityType参数无效”} | 工单activityType参数无效 | 检查工单activityType参数是否有效。 |
| 120001 | {“errcode”:120001,”errmsg”:”文件上传数量错误”} | 文件上传数量错误 | 检查上传文件流参数是否已设置。 |
| 120002 | {“errcode”:120002,”errmsg”:”文件上传大小错误”} | 文件上传大小错误 | 检查上传文件流参数是否为file。 |
| 120003 | {“errcode”:120003,”errmsg”:”文件上传错误”} | 文件上传错误 | 文件上传异常，请联系云客服客户人员咨询。 |
| 130001 | {“errcode”:130001,”errmsg”:”客户信息不存在”} | 客户信息不存在 | 检查客戶id是否正确。 |
| 130002 | {“errcode”:130002,”errmsg”:”客户名称和手机号不能都为空”} | 客户名称和手机号不能都为空 | 检查客户名称和手机号是否都为空。 |
| 130003 | {“errcode”:130003,”errmsg”:”客户已存在”} | 客户已存在 | 通过手机号或者客户姓名发现库中已存在客户。 |
| 130004 | {“errcode”:130004,”errmsg”:”手机号已存在”} | 手机号已存在 | 开启手机号去重后发现当前手机号已被别的客户使用。 |
| 130005 | {“errcode”:130005,”errmsg”:”客户ID不能为空”} | 客户ID不能为空 | 客户ID为必填项不能为空。 |
| 130006 | {“errcode”:130006,”errmsg”:”客户批量删除每次最多处理500条”} | 客户批量删除每次最多处理500条 | 客户批量删除条数限制。 |
| 130007 | {“errcode”:130007,”errmsg”:”客户自定义字段获取失败”} | 客户自定义字段获取失败 | 查询自定义字段接口时出错。 |
| 130008 | {“errcode”:130008,”errmsg”:”更新时获取库中客户自定义字段失败”} | 更新时获取库中客户自定义字段失败 | 更新客户时获取库中客户自定义字段失败。 |
| 130009 | {“errcode”:130009,”errmsg”:”没有查询到当前客户等级”} | 没有查询到当前客户等级 | 通过前端传送的客户等级在库中查不出数据。 |
| 130010 | {“errcode”:130010,”errmsg”:”没有查询到当前客户来源”} | 没有查询到当前客户来源 | 通过前端传送的客户来源在库中查不出数据。 |
| 130011 | {“errcode”:130011,”errmsg”:”客户名称或地址或邮箱长度大于最大值100个字符”} | 客户名称或地址或邮箱长度大于最大值100个字符 | 客户名称或地址或邮箱长度大于最大值100个字符。 |
| 130012 | {“errcode”:130012,”errmsg”:”客户昵称或手机或手机备注或邮箱备注或微信或微信备注长度大于最大值20个字符”} | 客户昵称或手机或手机备注或邮箱备注或微信或微信备注长度大于最大值20个字符 | 客户昵称或手机或手机备注或邮箱备注或微信或微信备注长度大于最大值20个字符。 |
| 130013 | {“errcode”:130013,”errmsg”:”客户备注长度大于最大值200个字符”} | 客户备注长度大于最大值200个字符 | 客户备注长度大于最大值200个字符。 |
| 130014 | {“errcode”:130014,”errmsg”:”客户名称不能为空”} | 客户名称不能为空 | 客户名称为必填不能为空。 |
| 130015 | {“errcode”:130015,”errmsg”:”客户关联访客ID大于最大值36个字符”} | 客户关联访客ID大于最大值36个字符 | 客户关联访客ID大于最大值36个字符。 |
| 130016 | {“errcode”:130016,”errmsg”:”客户省或市或区大于最大值20个字符”} | 客户省或市或区大于最大值20个字符 | 客户省或市或区大于最大值20个字符。 |
| 130017 | {“errcode”:130017,”errmsg”:”当前联系计划编号无效”} | 当前联系计划编号无效 | 请检查当前联系计划编号输入是否正确。 |
| 130018 | {“errcode”:130018,”errmsg”:”客户自定义日期格式不正确”} | 客户自定义日期格式不正确 | 请检查输入的年月日格式是否正确。 |
| 130019 | {“errcode”:130019,”errmsg”:”客户自定义日期时间格式不正确”} | 客户自定义日期时间格式不正确 | 请检查输入的年月日时分秒格式是否正确。 |
| 130020 | {“errcode”:130020,”errmsg”:”客户自定义数字不是正整数”} | 客户自定义数字不是正整数 | 客户自定义数字必须是正整数。 |
| 130021 | {“errcode”:130021,”errmsg”:”客户联系计划备注内容不能大于最大值300”} | 客户联系计划备注内容不能大于最大值300 | 客户联系计划备注内容不能大于最大值300。 |
| 130022 | {“errcode”:130022,”errmsg”:”删除客户时客户ID不能为空”} | 删除客户时客户ID不能为空 | 删除客户时客户ID为必填不能为空。 |
| 130023 | {“errcode”:130023,”errmsg”:”客户ID无效”} | 客户ID无效 | 请检查当前客户ID输入是否正确。 |
| 130024 | {“errcode”:130024,”errmsg”:”客户联系计划联系内容不能为空”} | 客户联系计划联系内容不能为空 | 客户联系计划联系内容为必填不能为空。 |
| 130025 | {“errcode”:130025,”errmsg”:”客户网站大于最大值100个字符”} | 客户网站大于最大值100个字符 | 客户网站大于最大值100个字符。 |
| 130026 | {“errcode”:130026,”errmsg”:”客户必填字段或自定义字段不能为空”} | 客户必填字段或自定义字段不能为空 | 客户必填字段或自定义字段不能为空。 |
| 130027 | {“errcode”:130027,”errmsg”:”获取租户启用字段错误”} | 获取租户启用字段错误 | 获取租户客户模板客户字段展示字段报错。 |
| 140001 | {“errcode”:140001,”errmsg”:”座席工号不能为空”} | 座席工号不能为空 | 检查座席工号是否为空。 |
| 140002 | {“errcode”:140002,”errmsg”:”座席工号无效”} | 座席工号无效 | 检查座席工号是否有效。 |
| 140003 | {“errcode”:140003,”errmsg”:”座席信息不存在”} | 座席信息不存在 | 检查座席工号是否有效。 |
| 140004 | {“errcode”:140004,”errmsg”:”座席已禁用，无操作权限！”} | 座席已禁用，无操作权限！ | 检查座席是否已禁用。 |
| 140005 | {“errcode”:140005,”errmsg”:”执行座席工号无效”} | 执行座席工号无效 | 请检查输入的执行座席工号是否正确。 |
| 140006 | {“errcode”:140006,”errmsg”:”日期格式不正确,必须为yyyy-MM-dd格式”} | 日期格式不正确,必须为yyyy-MM-dd格式 | 日期格式不正确,必须为yyyy-MM-dd格式。 |
| 150001 | {“errcode”:150001,”errmsg”:”通话记录ID无效”} | 通话记录id不存在 | 检查通话记录id是否有效。 |
| 150002 | {“errcode”:150002,”errmsg”:”kind只能为0或者1”} | kind只能为0或者1 | 检查kind是否为1或者0。 |
| 150003 | {“errcode”:150003,”errmsg”:”时间格式不正确”} | 时间格式不正确 | 检查时间格式是否正确。 |
| 150004 | {“errcode”:150004,”errmsg”:”开始时间不能大于结束时间”} | 开始时间不能大于结束时间 | 检查两个时间差是否有效。 |
| 150005 | {“errcode”:150005,”errmsg”:”时间若要填写,则两个都必填”} | 时间若要填写,则两个都必填 | 检查是否只填写一个日期。 |
| 150006 | {“errcode”:150006,”errmsg”:”当all为false时,direction字段必须为call in或call out”} | 当all为false时,direction字段必须为call in或call out | 检测当all为false时,direction字段必须为call in或call out |
| 150007 | {“errcode”:150007,”errmsg”:”当前座席不在线，无法发起外呼”} | 当前座席不在线，无法发起外呼 | 检测发起外呼的座席是否正常在线 |
文档更新时间: 2024-04-26 14:23 作者：admin
