API错误码

本文为您提供API接口错误码列表,请根据错误码和对应错误信息排查问题。

业务错误码

API错误码

错误信息

操作建议

OK

请求成功

isp.RAM_PERMISSION_DENY

RAM权限不足

请您为当前使用的RAM用户授权,具体操作请参见为RAM用户授权

isv.OUT_OF_SERVICE

业务停机

请您在费用中心检查账户是否欠费并及时充值。

isv.PRODUCT_UN_SUBSCRIPT

未开通云通信产品的阿里云客户

请您检查当前账号是否已开通语音服务产品

isv.PRODUCT_UNSUBSCRIBE

产品功能未开通

请您在语音服务功能开通页面确认是否已开通API对应的功能。

isv.TTS_TEMPLATE_ILLEGAL

TTS模板不合法

请您登录语音服务控制台,在添加模板页面检查模板是否存在。更多操作请参见创建语音模板

isv.VOICE_ROBOT_CALLEE_LIMIT

被叫号码超过1000

请您调整callee数量后再调用接口。

isv.BUSINESS_LIMIT_CONTROL

触发业务流控限制。流控限制分为分钟级、小时级和天级共三种

请您在流控限制范围内调用接口。

说明
  • 对同一个“资质+用途”下的主叫进行流控限制:1次/分钟、5次/小时、20次/24小时(流控规则计时从第一次正常外呼开始)。

  • 若您需要调整流控限制,请参见呼叫设置申请调整。

isv.VOICE_ROBOT_NOT_PERIOD

发送时间不能在限制时段内

请您调整呼叫时间后再重新调用接口。

isv.MOBILE_COUNT_OVER_LIMIT

手机号码数量超过限制

请您减少手机号码数量后再重新调用接口。

isv.VOICE_CALL_PERIOD_ERROR

获取语音呼叫时段失败

请您调整呼叫时间后再重新调用接口。

isv.VOICE_CALL_FAIL

呼叫发起失败

请登录语音服务控制台业务统计页面,查看语音呼叫失败原因。

isv.BILLID_NOT_EXIST

计费账号不存在

请您登录语音服务控制台,在号码管理页面确认主叫号码是否属于您的账号。

isv.BLACK_KEY_CONTROL_LIMIT

模板变量中存在黑名单关键字

请您确认模板是否存在非法内容。更多信息请参见语音模板规范

isv.COMPLAINT_REJECT

防骚扰拦截

主叫号码被呼叫拦截,请您确认号码是否存在投诉中或者号码已被投诉,导致呼叫受限。建议您更换被叫号码后测试呼叫。

isv.TEMPLATE_ILLEGAL

模板非法或不存在

请您登录语音服务控制台,检查模板是否存在。更多操作请参见创建语音模板

isv.TEMPLATE_PARAMS_ILLEGAL

模板变量非法

请您修改模板变量中存在的非法关键词或公共号池语言验证码,更多变量规范请参见语音模板规范

isv.AMOUNT_NOT_ENOUGH

账户余额不足

请您及时充值,调用接口前请确认当前账户余额是否足以支付预计使用量。

isv.ACCOUNT_NOT_EXISTS

账户不存在

请您确认AccessKeyId账号信息。

isv.ACCOUNT_ABNORMAL

账户异常

请您检查账户是否欠费或者稍后重新调用接口。

isv.DISPLAY_NUMBER_ILLEGAL

号显不合法

请您检查主叫或者被叫号码格式是否存在异常字符。

isv.INVALID_PARAMETERS

参数异常

请您确认传入的参数字段或对应的值是否正确。

isv.PARAM_NOT_SUPPORT_URL

变量不支持URL参数

请您检查是否通过变量透传了URL或敏感信息。

isv.MOBILE_NUMBER_ILLEGAL

号码格式非法

请您确认号码格式是否正确。

isp.RES_OWNER_ID_UNKNOWN

找不到资源归属的阿里云ID

请您检查阿里云账号是否正确。

isv.VOICE_ROBOT_NOT_AUDIT

robot没有审核通过

请您重新提交审核。

isv.VOICE_ROBOT_ID_NULL

robot数据没有查到

请您检查参数是否缺失机器人ID。

isv.RAM_CHECK_FAILED

RAM权限校验失败

请您检查RAM相关配置是否符合规则。

isv.TEMPLATE_MISSING_PARAMETERS

模板参数缺失

请您确认模板参数是否填写完整。

100008

数据不存在

请您确认语音API、呼叫的机器人或任务信息是否存在。

isv.INVALID_JSON_PARAM

JSON参数不合法

请您确认JSON参数的格式是否合法。

isv.VOICE_FILE_ILLEGAL

语音文件非法

请您确认语音文件是否存在或者是否通过审核。

isv.PHONE_NUMBER_IN_BLACK_LIST

号码黑名单

被叫号码被投诉,导致号码在黑名单中无法呼叫。

isv.PHONE_NUMBER_RETRIEVE

号码强制回收

该号码被强制回收,请您尽快更换号码。

isp.USER_NOT_EXIST

用户信息不存在

系统异常或用户在黑名单中。

isv.PARAM_LENGTH_LIMIT

模板参数长度非法

请您修改模板参数长度,不超过1000个字符。

isv.VOICE_CODE_PARAM_ILLEGAL

语音Code参数非法

请确认SmartCall接口的VoiceCodeParam参数格式是否正确。

  • VoiceCodeParam参数长度不超过1000字符。

  • VoiceCodeParam参数格式为JSON格式。

  • TTS参数传递字符串,格式为JSON。必须与VoiceCode的TTS参数对应。

isp.USER_ASSERT_NOT_EXIST

用户信息获取失败

请您确认是否已开通对应云产品,如果已开通,建议您重新调用接口。

isv.HIT_VOICE_SECURITY_RULE

主叫号码已关停,命中安全管控策略

请您更换主叫号码(状态为可用的号码)后重新外呼。

说明

您可以在语音服务控制台真实号管理页面查询号码状态。

isv.ASR_MODEL_ERROR

无权使用ASR模型

ASR模型不存在,请您确认是否拥有该ASR模型。

isp.UNKNOWN

未知异常

建议您稍后重新调用接口。

isp.SYSTEM_ERROR

系统临时错误

建议您稍后重新调用接口。

isp.GATEWAY_ERROR

系统异常

建议您稍后重新调用接口。

公共错误码

错误码

错误信息

操作建议

InvalidAccessKeyId

AccessKey非法

请您登录RAM控制台确认AccessKey是否存在。

InvalidAccessKeyId.NotFound

AccessKey不存在

请您登录RAM控制台确认AccessKey是否存在。

InvalidAccessKeyId.Inactive

AccessKey无效

请您登录RAM控制台确认AccessKey是否激活。

InvalidAction.NotFound

Action不存在

API不存在。

  • 如果您在使用SDK调用接口,请确认Action参数是否正确。

  • 如果您在使用HTTP调用接口,请确认Action参数是否正确。

InvalidVersion

API版本号错误

建议您在OpenAPI 开发者门户页面使用升级版SDK

  • 如果您在使用SDK调用接口,请确认API调用时的Version参数是否填写正确。

  • 如果您在使用HTTP调用接口,请确认公共请求参数中Version参数是否填写正确。

InvalidTimeStamp.Expired

API请求中的TimeStamp字段无效

请您根据公共请求参数中TimeStamp参数的要求,合理设置TimeStamp参数值。

说明

如果您在使用SDK调用接口,请确认服务器的时间是否正确。

InvalidParameters

参数非法

请您根据语音服务API参考,确认参数填写是否正确。

MissingAccessKeyId

AccessKeyId参数缺失

  • 如果您在使用SDK调用接口,请确认是否已设置Client的AccessKeyId。

  • 如果您在使用HTTP调用接口,请确认是否已传递AccessKeyId。

MissingVoiceCode

VoiceCode参数缺失

请您确认在调用API时,是否已上传VoiceCode参数。

MissingStartCode

StartCode参数缺失

请您确认在调用API时,是否已上传StartCode参数。

MissingCallId

CallId参数缺失

请您确认在调用API时,是否已上传CallId参数。

MissingCalledNumber

CalledNumber参数缺失

请您确认在调用API时,是否已上传CalledNumber参数。

MissingTtsCode

TtsCode参数缺失

请您确认在调用API时,是否已上传TtsCode参数。

SignatureDoesNotMatch

API请求的签名错误

  • 如果您在使用SDK调用接口,请确认参数是否正确。若SDK不是最新版本,建议升级到最新版本。

  • 如果您在使用HTTP调用接口,请根据调用机制调整签名的计算形式,确保和文档中的保持一致。建议您使用SDK调用。

SignatureNonceUsed

SignatureNonce已使用过

  • 如果您在使用SDK调用接口,请确认是否使用同一个签名发送请求。若SDK不是最新版本,建议升级到最新版本。

  • 如果您在使用HTTP调用接口,请根据调用机制调整签名的计算形式,确保和文档中的保持一致。建议您使用SDK调用。

Throttling.User

触发API用户级流控

请您参考流控信息找到触发流控的API接口。

UnauthorizedOperation

未授权的操作

请您确认Action是否存在。

ServiceUnavailable

服务不可用

云产品服务异常,建议您稍后重新调用接口。

说明

MissingXX参数类型的错误码,解决方案一致,即确认是否已上传XX参数。