接口异常情况说明
接口异常情况即当发起请求时，即 response body 中的 errcode 值不为 0 时，说明请求参数可能存在异常，或NICE综合管理平台在执行上传的任务执行中发生异常。以下是错误码的说明：
Token异常相关
| errcode | message | 说明 |
|---|
| 400001 | 参数错误 | |
| 400002 | 未知平台 | |
| 400003 | Authorization格式异常 | 请检查请求头中是否携带了Authorization，以及是否按文档中"API统一调用说明"生成的 |
| 400004 | Authorization已过期 | |
| 400005 | Authorization无法解析 | |
| 403011 | 授权已过期 | |
| 403012 | 无权限使用 | |
| 403013 | token签名错误 | |
| 403014 | token过期 | |
| 403015 | token签名在某个时间点之后才能用 | |
| 403016 | token签名未知错误 | |
| 403017 | token内容格式错误 | |
任务相关
| errcode | message | 说明 |
|---|
| 404011 | 参数错误：缺失项目 key | 请求参数中缺少 project_key |
| 404013 | 参数错误：缺失任务类型 task_type | 请求参数中缺少 task_type |
| 404016 | 参数错误：缺失任务文件 task_file 或 task_file_url | 请求参数中缺少 task_file 或 task_file_url |
| 404021 | 参数错误：缺失任务编号 task_no | 请求参数中缺少 task_no |
| 404121 | 项目 key 不存在 | 请使用通过项目列表获取到的 project_key |
| 404128 | 用户上传文件类型错误 | 请检查 task_type 是否正常 |
| 404133 | task_no 不存在 | 请使用正确的任务编号 task_no |
| 404134 | 任务状态错误，未处理完成！ | 获取结果文件时可能会发生的错误。请确保任务是处理完后状态后，才请求获取结果文件接口 |
| 404136 | 语言类型： task_language_type 错误 | 请使用正确的语言类型 task_language_type |
| 407000 | 文件不存在 | 通过文件 url 获取不到文件，请检查 url |
| 407001 | 用户上传文件类型不匹配 | 用户上传了非法的文件 |
| 407002 | 用户上传文件太大 | 用户上传了过大的文件 |
| 407005 | 目标文件已做归档处理，如需调用，请联系NICE综合管理平台产品支持团队（mengxuan.shi@zebra-c.com） | 归档处理 |
项目相关
| errcode | message | 说明 |
|---|
| 408000 | 项目不存在或已删除 | |
| 408001 | 项目名称不能为空，或长度超过100 | |
| 408002 | 项目名称不能包含特殊字符 | |
| 408003 | 项目无法使用该执行方式 | 该项目无法使用指定的执行方式，请根据项目可用执行方式接口返回的执行方式列表范围内进行选择 |
| 408004 | 项目执行方式无改变 | 项目的执行方式未发生改变，修改无效 |
| 408005 | 项目与云平台不匹配 | 项目所属云平台和header中携带云平台不匹配 |
| 408006 | 项目key参数类型错误 | |
| 408007 | 请指定执行方式 | |
| 408008 | 执行方式参数格式错误 | |
| 408009 | 执行方式不存在或已删除 | |
| 408010 | 项目指标参数异常 | |
| 408011 | 项目指标参数格式错误 | |
| 408012 | 项目指标存在不可用指标 | |
| 408013 | 项目指标绑定系统异常 | |
| 401030 | 参数错误：缺少参数keyword_list | 缺少参数keyword_list |
| 401032 | 参数错误：keyword_list | keyword_list格式错误 |
| 401033 | 参数错误：缺少参数keywords | 缺少参数keywords |
| 401034 | 参数错误：keywords | keywords格式错误 |
用户相关
| errcode | message | 说明 |
|---|
| 401001 | 参数错误：缺少功能权限 | 缺少参数permissions |
| 401002 | 参数错误：account错误 | 参数account错误 |
| 401003 | 参数错误：status错误 | 参数status错误 |
| 401004 | 参数错误：该用户名已存在 | 用户名(name)已存在，需修改成其他用户名 |
| 401005 | 参数错误：缺少用户名 | 缺少参数name |
| 401006 | 参数错误：缺少项目权限 | 缺少参数projects |
| 401007 | 参数错误：缺少account | 缺少参数account |
| 401008 | 参数错误：缺少user_code | 缺少参数user_code |
| 401009 | 参数错误：缺少状态值 | 缺少参数status |
| 401010 | 参数错误：项目权限错误 | 参数projects错误 |
| 401011 | 参数错误：功能权限错误 | 参数permissions错误 |
| 401101 | 数据保存失败 | 数据保存失败，请联系NICE平台技术人员 |
指标相关
| errcode | message | 说明 |
|---|
| 40001 | 参数错误 | 参数存在错误，需要检查必填项、字段的类型等问题，注意必须包含group_key |
| 40002 | 指标不存在 | 选择的指标不存在 |
| 409000 | 指标场景参数异常 | 参数存在错误，需要检查必填项、字段的类型等问题 |
| 409001 | 指标属性参数需要指定 | 需要指定属性参数：type |
| 409002 | 指标属性参数格式错误 | |
| 409003 | 指标属性参数值超出可选范围 | |
| 409004 | 指标名称参数为必填 | |
| 409005 | 指标名称过短 | |
| 409006 | 指标名称过长 | |
| 409007 | 指标描述信息为必填 | |
| 409008 | 指标描述信息为字符串格式 | |
| 409009 | 指标描述信息过短 | |
| 409010 | 指标描述信息过长 | |
| 409011 | 指标场景不存在 | |
| 409012 | 指标场景在云平台下不可用 | |
| 409013 | 指标场景获取品牌失败 | 根据group_key获取场景所属品牌信息失败 |
用户声纹
| errcode | message | 说明 |
|---|
| 401016 | 参数错误：缺少声纹类型 | 请按文档补充请求参数 voice_type |
| 401017 | 参数错误：缺少声纹ID | 请按文档补充请求参数 voice_code |
| 401018 | 参数错误：缺少声纹文件 | 请按文档补充请求参数 voice_file |
| 401019 | 参数错误：缺少声纹文件url | 请按文档补充请求参数 voice_url |
| 401020 | 参数错误：声纹类型错误 | 请按照文档处理声纹类型 voice_type 的值 |
| 401021 | 一个用户最多只能添加3条声纹 | 经过我们测试，同一用户最多有三个（非删除状态的）声纹即可满足角色识别。有其他需求您可与业务支持人员联系解决方式 |
| 401022 | 声纹文件为空 | 请检查声纹文件 |
| 401023 | 参数错误：user_code 错误 | 请检查 user_code 字段的值是否正确 |
| 401024 | 参数错误：缺少is_delete | 请按文档补充请求参数 is_delete |
| 401025 | 参数错误：voice_code错误 | 请确认 voice_code 参数是否是新增或修改时的请求参数，以及是否已经被删除过 |
| 401026 | 声纹解析失败 | 发生概率很小，发生后可联系业务支持人员获取详细信息 |
| 401027 | 录制声纹大小不能小于4KB | 需要适当延长用户声纹的时长，声纹文件太小将导致不可用 |
| 401028 | 录制声纹大小不能超过10MB | 经过我们的测试，您没必要传输10MB以上大小的声纹文件 |
| 401029 | 有效声音太短（小于3秒） | 需要上传超过3s的有效录音 |
其他异常
| errcode | message | 说明 |
|---|
| 429 | Too Many Attempts. | 接口请求过于频繁，请稍后再试 |
