全局错误码
企业应用每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。 注意:开发者的程序应该根据errcode来判断出错的情况,而不应该依赖errmsg来匹配,因为errmsg可能会调整。
全局返回码说明如下:
错误码 | 错误说明 | 排查方法 |
---|---|---|
-1 | 系统繁忙,请稍后重试 | 服务器暂不可用,建议稍候重试。建议重试次数不超过3次。 |
0 | 请求成功 | 接口调用成功 |
10001 | 系统错误 | - |
10004 | 未授权,请联系管理员 | 请检查appkey是否正确 |
10005 | 缺少参数或参数格式不对,请仔细阅读接口文档! | 请检查请求参数是否正确 |
10006 | 签名错误,签名校验失败 | 请检查是否按签名验签正确签名,同时签名值需要做URL编码 |
10007 | 参数类型错误 | 请检查接口中的参数类型是否正确。 |
10010 | token过期,请重新请求token | 免登token只能使用一次,有效时间为30分钟 |
10011 | 未知appKey,请检查appKey是否正确! | 请检查传入的appKey是否正确 |
10012 | 越权操作,没有权限查看该数据! | 请检查appkey和实际请求数据的所属公司是否一致 |
10013 | 超过访问限制 | 接口调用的频率默认限制为每分钟200次,其中批量打卡接口限制为每分钟50次,加班记录同步接口,每分钟100次 |
10014 | 分页查询数量超限,一页最多100个员工 | 请检查分页查询的参数是否超过限制 |
10015 | 时间戳间隔超出限制 | 请求参数中的时间戳,5分钟内有效 |
10016 | 当前访问URL的IP地址未授权,请联系管理员开通访问权限 | v1版本的接口请求ip校验不通过 |
10017 | 文件格式不支持 | 如果是文件上传,请检查文件格式是否支持,接口目前支持的文件格式有 jpg/jpeg/png/pdf/doc/docx/rar/zip |
10018 | 超过了文件大小限制 | jpg/jpeg/png/大小限制2M,pdf/doc/docx/rar/zip大小限制10M |
10021 | 参数错误 | 请检查是否缺少参数以及参数格式是否正确 |
20101 | 未查找到信息,请确认id是否正确 | 检查员工id是否正确 |
20103 | 您的账户在职员工已超过签约员工数量,请及时联系客户经理或“小薪在线”增购 | - |
20104 | 文件key不属于当前员工,请仔细核查 | 请检查文件key是否和员工匹配 |
20105 | 文件key对应的文件不存在 | 请检查文件key是否正确 |
20106 | 离职减员月格式不对,正确格式:yyyyMM | - |
20107 | 员工状态值不存在 | 请检查员工状态是否正确,目前接口支持的员工状态 0-在职,1-离职,2-待入职,8-删除 |
20108 | 查询页不能为空,起始页为0 | - |
20109 | 员工身份证照字段格式错误 | 员工入职或者更新时,如果传了"身份证照"字段,请检查字段格式是否正确。 |
20110 | 城市信息不正确 | 请检查城市信息是否在城市列表中。 |
20111 | 员工雇佣类型错误 | 请检查雇佣类型是否正确,目前系统支持的雇佣类型:0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包 |
20112 | 分组字段类型错误 | 请检查分组类型是否正确,目前接口支持的分组类型:1-合同记录,7-教育经历,8-工作经历,9-培训经历,10-证书记录,11-联系人记录 |
20113 | 分组字段参数错误 | 请检查分组字段参数是否在分组字段信息中 |
20201 | 打卡失败 | 请检查打卡的员工id是否正确 |
20202 | 时间格式不对! | 请检查参数中的时间格式是否正确 |
20205 | 批量打卡记录不得超过100条 | 系统目前只支持批量上传打卡记录为100条 |
20206 | 打卡记录查询时间参数错误 | 请检查查询参数中的打卡开始时间和结束时间是否正确 |
20207 | 打卡记录查询时间间隔超过7天 | 目前系统只支持查询7天的打卡记录。请检查查询的时间间隔是否超过7天 |
20208 | 打卡记录输入员工数量超限100人 | 目前系统只支持一次查询100个员工的打卡记录 |
20209 | 打卡记录每页数量1-100之间 | - |
20301 | 没有查找到该公司,请确认id是否正确 | 检查公司id是否正确 |
20303 | 部门不存在 | 检查部门id是否正确 |
20401 | 员工工资项更新记录不得超过100条 | 目前系统只支持一次更新100条工资项 |
20402 | 员工工资传参JSON格式不正确 | 请检查员工工资项的json串格式是否正确 |
20403 | 公司员工工资信息不匹配 | 请检查员工和公司信息是否匹配 |
20404 | 员工工资项数值项校验不匹配 | 请检查工资项的数值项是否超过大小限制 |
20405 | 员工工资更新失败 | 具体错误信息查看返回的detailMsg说明 |
20408 | 存在员工不支持更新工资项信息 | 工资项只支持更新在职和离职的员工 |
20502 | 工资报表参数不正确 | 请检查报表查询相关的参数是否正确,具体错误信息查看返回的detailMsg说明 |
20504 | 调薪流水记录不存在 | 查询到的调薪记录为空 |
20701 | 审批列表查询,pageNo不能小于0 | - |
20702 | 审批列表查询,pageSize需要在1~100之间 | - |
20703 | 审批详情查询,processId需要大于0 | - |
20705 | 审批列表查询,查询参数错误 | 请检查查询参数是否正确 |
20801 | 无效免登token | 错误的免登token或者免登token已过期 |
20802 | 缺少跳转参数 | 缺少免登跳转参数,对于需要跳转参数的免登页面,请检查是否传了免登参数 |
20803 | 无效的跳转参数 | 免登参数不匹配,请检查免登参数 |
20804 | 免登跳转参数格式不对 | 请检查免登参数格式是否正确 |
20805 | 无效审批参数 | 免登到审批详情页缺少参数。 |
20806 | 免登员工不存在 | 请检查免登的员工id或者手机号是否正确 |
20807 | 不支持的免登类型 | 系统目前只支持免登到h5和pc端。 |
20901 | 招聘全数据报表查询,pageNo不能小于0 | - |
20902 | 招聘全数据报表查询,pageSize需要在1~100之间 | - |
20903 | 查询时间格式不对!正确格式:yyyy-MM-dd | - |
20904 | 结束时间不能小于开始时间! | - |
30001 | 操作失败 | 请检查业务参数是否正确 |
50000 | 系统内部错误 | 服务器暂不可用,建议稍候重试。建议重试次数不超过3次。 |
910002 | 权限认证不通过,没有访问该接口的权限 | 请确认当前应用是否开通对应接口的访问权限 |
910003 | 请求IP不在设置的白名单中 | 请确认当前请求的IP是否在设置的IP白名单当中。 |
910004 | 不合法的access_token | 请确认当前请求携带的access_toke是否在有效期内。access_token的有效期为2小时 |