阿里云短信API接口调用错误码及解决方法

阿里云短信调用API接口会产生接口调用错误码，常见接口调用错误码显示及修改建议，本文为您介绍短信接口调用时常见的错误码。调用API接口会产生接口调用错误码，常见接口调用错误码显示及修改建议，请参见以下列表。

调用接口成功后，运营商异步返回的短信发送状态错误码。请参见短信发送状态回执错误码。

阿里云短信地址：立即直达

阿里云短信免费试用产品：

阿里云通信短信服务支持国内和国际快速发送验证码、短信通知和推广短信，服务范围覆盖全球200多个国家和地区。<<点击进入申请免费试用

错误码（Code）

错误信息（Message）

原因及解决方案

OK

OK

表示接口调用成功。

isv.SMS_SIGNATURE_SCENE_ILLEGAL

短信所使用签名场景非法

原因：签名的适用场景与短信类型不匹配。

isv.EXTEND_CODE_ERROR

扩展码使用错误，相同的扩展码不可用于多个签名

原因：发送短信时不同签名的短信使用了相同扩展码。

解决方案：在调用短信发送接口时，不同的短信签名使用不同的扩展码。

isv.DOMESTIC_NUMBER_NOT_SUPPORTED

国际/港澳台消息模板不支持发送境内号码

原因：国际或港澳台消息模板仅支持发送国际、港澳台地区的号码。

解决方案：如果想发送境内短信，请申请国内短信模版。

isv.DENY_IP_RANGE

源IP地址所在的地区被禁用

原因：被系统检测到源IP属于非中国（内地）大陆地区。

解决方案：请将源IP地址修改为中国（内地）大陆地区的IP地址。港澳台、及海外地区的IP地址禁止发送国内短信业务。

isv.DAY_LIMIT_CONTROL

触发日发送限额

原因：已经达到您在控制台设置的短信日发送量限额值。

解决方案：如需修改限额，请在短信服务控制台左侧导航栏中单击国内消息设置>安全设置，修改发送总量阈值。

isv.SMS_CONTENT_ILLEGAL

短信内容包含禁止发送内容

原因：短信内容包含禁止发送内容。

解决方案：修改短信文案。

isv.SMS_SIGN_ILLEGAL

签名禁止使用

原因：签名禁止使用。

解决方案：请在短信服务控制台中申请符合规定的签名。

isp.RAM_PERMISSION_DENY

RAM权限DENY

原因：RAM权限不足。

解决方案：请为当前使用的AK对应子账号进行授权：AliyunDysmsFullAccess（管理权限）。具体操作请参见：创建RAM用户。

isv.OUT_OF_SERVICE

业务停机

原因：余额不足。余额不足时，套餐包中即使有短信额度也无法发送短信。

解决方案：请及时充值。

如果余额大于零仍报此错误，请通过工单联系工程师处理。

isv.PRODUCT_UN_SUBSCRIPT

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

原因： 该AK所属的账号尚未开通云通信的服务，包括短信、语音、流量等服务。

解决方案：当出现此类提示报错需要检查当前AK是否已经开通阿里云云通信短信服务，如已开通消息服务，则参照消息服务文档调用接口。

isv.PRODUCT_UNSUBSCRIBE

产品未开通

原因： 该AK所属的账号尚未开通当前接口的产品，例如仅开通了短信服务的用户调用语音接口时会产生此报错信息。

解决方案：检查AK对应账号是否已开通调用接口对应的服务。开通短信服务，请单击短信服务产品介绍。

isv.ACCOUNT_NOT_EXISTS

账户不存在

原因： 使用了错误的账户名称或AK。

解决方案：请确认账号信息。

isv.ACCOUNT_ABNORMAL

账户异常

原因：账户异常。

解决方案： 请确认账号信息。

isv.SMS_TEMPLATE_ILLEGAL

短信模版不合法

原因： 短信模板不存在，或未经审核通过。

解决方案： 参数TemplateCode请传入审核通过的模版ID，模版ID请在控制台中模板管理页面查看。

isv.SMS_SIGNATURE_ILLEGAL

短信签名不合法

原因： 签名不存在，或未经审核通过。

解决方案：参数SignName请传入审核通过的签名名称，签名请在控制台中签名管理页面查看。

isv.INVALID_PARAMETERS

参数异常

原因： 参数格式不正确。

解决方案：请根据对应的API文档检查参数格式。

例如，短信查询接口QuerySendDetails的参数SendDate日期格式为yyyyMMdd，正确格式为20170101，错误格式为2017-01-01。

isp.SYSTEM_ERROR

系统错误

原因： 系统错误。

解决方案：请重新调用接口，如仍存在此情况请创建工单反馈工程师查看。

isv.MOBILE_NUMBER_ILLEGAL

非法手机号

原因：手机号码格式错误。

isv.MOBILE_COUNT_OVER_LIMIT

手机号码数量超过限制

原因：参数PhoneNumbers中指定的手机号码数量超出限制。

解决方案：请将手机号码数量限制在1000个以内。

isv.TEMPLATE_MISSING_PARAMETERS

模版缺少变量

原因： 参数TemplateParam中，变量未全部赋值。

解决方案： 请JSON格式字符串为模板变量赋值。

例如，模版为您好${name}，验证码${code}，则参数TemplateParam可以指定为{"name":"Tom","code":"123"}。

isv.BUSINESS_LIMIT_CONTROL

业务限流

原因： 短信发送频率超限。

解决方案： 请将短信发送频率限制在正常的业务流控范围内。默认流控：使用同一个签名，对同一个手机号码发送短信验证码，支持1条/分钟，5条/小时 ，累计10条/天。

isv.INVALID_JSON_PARAM

JSON参数不合法，只接受字符串值

原因：参数格式错误，不是合法的JSON格式。

解决方案： 请在参数TemplateParam中指定正确的JSON格式字符串，例如{"code":"123"}。

isv.BLACK_KEY_CONTROL_LIMIT

黑名单管控

原因： 黑名单管控是指变量内容含有限制发送的内容，例如变量中不允许透传URL。

解决方案： 请检查通过变量是否透传了一些敏感信息。

isv.PARAM_LENGTH_LIMIT

参数超出长度限制

原因：参数超出长度限制。

解决方案：每个变量的长度限制为1~20字符。请修改参数长度。

isv.PARAM_NOT_SUPPORT_URL

不支持URL

原因： 黑名单管控是指变量内容含有限制发送的内容，例如变量中不允许透传URL。

解决方案： 请检查通过变量是否透传了URL或敏感信息。

isv.AMOUNT_NOT_ENOUGH

账户余额不足

原因： 当前账户余额不足。

解决方案：请及时充值。调用接口前请确认当前账户余额是否足以支付预计发送的短信量。

isv.TEMPLATE_PARAMS_ILLEGAL

模版变量里包含非法关键字

原因：变量内容含有限制发送的内容，例如变量中不允许透传URL。

解决方案： 请检查通过变量是否透传了URL或敏感信息。

SignatureDoesNotMatch

Specified signature is not matched with our calculation.

原因： 签名（Signature）加密错误。

InvalidTimeStamp.Expired

Specified time stamp or date value is expired.

原因： 一般由于时区差异造成时间戳错误，发出请求的时间和服务器接收到请求的时间不在15分钟内。

阿里云网关使用的时间是GMT时间。

解决方案：请使用GMT时间。

SignatureNonceUsed

Specified signature nonce was used already.

原因： 唯一随机数重复，SignatureNonce为唯一随机数，用于防止网络重放攻击。

解决方案： 不同请求请使用不同的随机数值。

InvalidVersion

Specified parameter Version is not valid.

原因： 版本号（Version）错误。

解决方案：请确认接口的版本号，短信服务的API版本号（Version）为2017-05-25。

InvalidAction.NotFound

Specified api is not found, please check your url and method

原因： 参数Action中指定的接口名错误。

解决方案： 请在参数Action中使用正确的接口地址和接口名。

isv.SIGN_COUNT_OVER_LIMIT

一个自然日中申请签名数量超过限制。

原因：一个自然日中申请签名数量超过限制。

解决方案：合理安排每天的签名申请数量，次日重新申请。

isv.TEMPLATE_COUNT_OVER_LIMIT

一个自然日中申请模板数量超过限制。

原因：一个自然日中申请模板数量超过限制。

解决方案：合理安排每天的模板申请数量，次日重新申请。

isv.SIGN_NAME_ILLEGAL

签名名称不符合规范。

原因：签名名称不符合规范。

解决方案：详情请参见个人用户签名规范或企业用户签名规范重新申请签名。

isv.SIGN_FILE_LIMIT

签名认证材料附件大小超过限制。

原因：签名认证材料附件大小超过限制。

解决方案：压缩签名认证材料至2 MB以下。

isv.SIGN_OVER_LIMIT

签名字符数量超过限制。

原因：签名的名称或申请说明的字数超过限制。

解决方案：修改签名名称或申请说明，并重新提交审核。

isv.TEMPLATE_OVER_LIMIT

签名字符数量超过限制。

原因：模板的名称、内容或申请说明的字数超过限制。

解决方案：修改模板的名称、内容或申请说明，并重新提交审核。

SIGNATURE_BLACKLIST

签名黑名单

原因：签名内容涉及违规信息，详情请参见个人用户签名规范或企业用户签名规范重新申请签名。

解决方案:修改签名内容。

isv.SHORTURL_OVER_LIMIT

一天创建短链数量超过限制

原因：一天创建短链数量超过限制。

解决方案：合理预估一天申请短链数量，第二天重新创建短链。

isv.NO_AVAILABLE_SHORT_URL

无有效短链

原因：客户当前并无有效短链。

解决方案：客户需重新申请有效短链，保证在短链有效期内调用短参生成接口。

isv.SHORTURL_NAME_ILLEGAL

短链名称非法

原因：短链名称非法。

解决方案：根据短链规范重新创建。

isv.SOURCEURL_OVER_LIMIT

原始链接字符数量超过限制

原因：原始链接字符数量超过限制。

解决方案：重新创建判断字符长度是否符合平台规则。

isv.SHORTURL_TIME_ILLEGAL

短链有效期期限超过限制

原因：选择短链有效期限超过30天限制。

解决方案：请保证短链有效期输入在30天以内。

isv.PHONENUMBERS_OVER_LIMIT

上传手机号个数超过上限

原因：单次调用上传手机号个数超过50000个上限。

解决方案：分多次调用短参生成接口，单次上传手机号个数不超过50000个。

isv.SHORTURL_STILL_AVAILABLE

原始链接生成的短链仍在有效期内

原因：原始链接生成的短链仍在有效期内，无需重复创建。

解决方案：待原始链接生成的短链失效后，再重新创建。或删除该短链后，重新创建。或使用新的原始链接，创建新的短链。

isv.SHORTURL_NOT_FOUND

没有可删除的短链

原因：未发现可以删除的短链，可能是该短链已被删除，或该短链并未成功创建。

解决方案：无需重复删除已删除的短链。

isv.ERROR_SIGN_NOT_MODIFY

签名不支持修改

原因：修改了通过审核的签名。

阿里云短信api接口调用错误码及解决方法：

阿里云短信api调用接口成功后，运营商异步返回的短信发送状态错误码，参考：常见的阿里云短信发送状态回执错误码