阿里云SMS，APi接口返回错误码

API错误码

更新时间：2023-06-29 16:33提交缺陷

产品详情

相关技术圈

我的收藏

调用API接口失败时，会返回错误码。本文档为您提供API接口错误码列表，请根据错误码和对应错误信息排查问题。

|--------------------------------------|------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 错误码（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.MONTH_LIMIT_CONTROL | 触发月发送限额 | 原因：已经达到您在控制台设置的短信月发送量限额值。 解决方案 ：如需修改限额，请登录短信服务控制台，在左侧导航栏，选择系统设置 > 国内消息设置 > 安全设置，修改月发送量总量阈值。 |
| isv.SMS_CONTENT_ILLEGAL | 短信内容包含禁止发送内容 | 原因：短信内容包含禁止发送内容。 解决方案：修改短信文案。 |
| isv.SMS_SIGN_ILLEGAL | 签名禁止使用 | 原因：签名禁止使用。 解决方案 ：请在短信服务控制台申请符合规定的签名。更多操作，请参见添加签名。 |
| isp.RAM_PERMISSION_DENY | RAM权限不足 | 原因：RAM权限不足。 解决方案 ：请为当前使用的AccessKey对应RAM用户进行授权：AliyunDysmsFullAccess（管理权限）。具体操作请参见授权RAM用户。 |
| isv.OUT_OF_SERVICE | 业务停机 | 原因：余额不足。业务停机时，套餐包中即使有短信额度也无法发送短信。 解决方案：请及时充值。 |
| isv.PRODUCT_UN_SUBSCRIPT | 未开通云通信产品的阿里云客户 | 原因：该AccessKey所属的账号尚未开通云通信的服务，包括短信、语音、流量等服务。 解决方案 ：当出现此类报错信息时，需要检查当前AccessKey是否已经开通阿里云短信服务。如已开通短信服务，则参照短信服务文档调用接口。 |
| isv.PRODUCT_UNSUBSCRIBE | 产品未开通 | 原因：该AccessKey所属的账号尚未开通当前接口的产品，例如仅开通了短信服务的用户调用语音服务接口时会产生此报错信息。 解决方案 ：检查AccessKey对应账号是否已开通调用对应接口的服务。如需开通服务，请参见短信服务或语音服务。 |
| isv.ACCOUNT_NOT_EXISTS | 账户不存在 | 原因：使用了错误的账户名称或AccessKey。 解决方案：请确认账号信息。 |
| isv.ACCOUNT_ABNORMAL | 账户异常 | 原因：账户异常。 解决方案 ：计费服务查询异常，请点击链接，打开钉钉扫码进入短信服务专属钉群。 |
| isv.SMS_TEMPLATE_ILLEGAL | 该账号下找不到对应模板 | 原因：在您的账号下找不到对应模板，可能AccessKey账号和模板归属于不同账号，或使用了未审核通过的模板。 解决方案 ：请检查您的AccessKey账号和模板是否属于同一个账号，或登录短信服务控制台，在模板管理页面查此模板是否审核通过。 |
| isv.SMS_SIGNATURE_ILLEGAL | 该账号下找不到对应签名 | 原因： * 在您的账号下找不到对应编号的签名，可能是AccessKey账号和签名归属于不同账号，或使用了未审核通过的签名。 * 您传入的签名有空格、问号、错别字等导致乱码。 解决方案： * 请检查您的AccessKey和签名是否属于同一个账号，或登录短信服务控制台，在签名管理页面查看此签名是否审核通过。 * 请检查您传入的签名格式是否正确，删除签名中的空格、特殊符号，修改错别字。签名规范请参见短信签名规范。 |
| isv.INVALID_PARAMETERS | 参数格式不正确 | 原因：参数格式不正确。 解决方案 ：请根据对应的API文档检查参数格式。 例如，短信查询QuerySendDetails接口的参数SendDate日期格式为yyyyMMdd，正确格式为20170101，错误格式为2017-01-01。 |
| isp.SYSTEM_ERROR | 系统出现错误，请重新调用 | 原因：系统出现错误。 解决方案：请重新调用接口。 |
| isv.MOBILE_NUMBER_ILLEGAL | 手机号码格式错误 | 原因：手机号码格式错误。 解决方案：参数PhoneNumbers请传入正确的格式。 * 国内消息：+/+86/0086/86或无任何前缀的11位手机号码，例如1595195****。 * 国际/港澳台消息：国际区号+号码，例如8520000****。 |
| isv.MOBILE_COUNT_OVER_LIMIT | 手机号码数量超过限制，最多支持1000条 | 原因：参数PhoneNumbers中指定的手机号码数量超出限制。 解决方案：请将手机号码数量限制在1000个以内。 |
| isv.TEMPLATE_MISSING_PARAMETERS | 模板变量中存在未赋值变量 | 原因：参数TemplateParam中，变量未全部赋值。 解决方案：请用JSON格式字符串为模板变量赋值。例如，模板为您好{name}，验证码{code}，则参数TemplateParam可以指定为{"name":"Tom","code":"123"}。 |
| isv.BUSINESS_LIMIT_CONTROL | 触发云通信流控限制 | 原因：达到云通信短信发送频率上限。 解决方案： * 请您将短信发送频率限制在正常的业务流控范围内，默认流控详情，请参见短信发送频率限制。 * 您还可登录短信服务控制台，在系统设置 > 国内消息设置 页面调整流控阈值。具体操作，请参见设置短信发送频率和频率限制白名单。 |
| isv.INVALID_JSON_PARAM | 参数格式错误，请修改为字符串值 | 原因：参数格式错误，不是合法的JSON格式，修改为字符串值。 解决方案 ：请在参数TemplateParam中指定正确的JSON格式字符串，例如{"code":"123"}。 |
| isv.BLACK_KEY_CONTROL_LIMIT | 黑名单管控 | 原因：黑名单管控是指短信号码命中黑名单，此类号码曾有过退订或投诉记录，不支持下发该类推广短信。 解决方案：推广短信建议规避该号码下发。 |
| isv.PARAM_LENGTH_LIMIT | 参数超过长度限制 | 原因：参数超过长度限制。 解决方案：针对2018年01月10日之后申请的短信通知类模板，变量限制为1~35个字符；验证码类模板，变量限制为4～6个字符，请修改参数长度。 |
| isv.PARAM_NOT_SUPPORT_URL | 变量不支持传入URL | 原因：变量内容中含有限制发送的内容，例如变量中不允许透传URL。 解决方案 ：请检查通过变量是否透传了URL或敏感信息。短信模板内容规范，请参见公共内容规范。 |
| isv.AMOUNT_NOT_ENOUGH | 账户余额不足 | 原因：当前账户余额不足。 解决方案：请及时充值。调用接口前请确认当前账户余额是否足以支付预计发送的短信量。 |
| isv.TEMPLATE_PARAMS_ILLEGAL | 传入的变量内容和实际申请模板时变量所选择的属性类型不配 | 原因：例如申请模板时对phone变量，选择变量属性为"电话号码"，但实际入参时对这个变量赋值非号码类型的内容。 解决方案 ：针对上述原因，phone变量入参应为：5-11位的国内标准手机号或固定电话号码，更多变量属性规范，请参见验证码模板变量属性规范或通知短信模板变量属性规范。 |
| SignatureDoesNotMatch | 客户端生成的签名与服务端不匹配 | 原因：签名（Signature）加密错误。 解决方案： * 如果使用SDK调用接口，请注意AccessKey ID和AccessKey Secret字符串赋值正确。 * 如果自行加密签名（Signature），请参见请求签名检查加密逻辑。 |
| InvalidTimeStamp.Expired | 时间戳或日期已过期 | 原因：一般由于时区差异造成时间戳错误，发出请求的时间和服务器接收到请求的时间不在15分钟内。 解决方案：请使用GMT时间。 说明 阿里云网关使用的时间是GMT时间。 |
| SignatureNonceUsed | 签名随机数已被使用 | 原因：唯一随机数重复，SignatureNonce为唯一随机数，用于防止网络重放攻击。 解决方案：不同请求请使用不同的随机数值。 |
| InvalidVersion | API版本号错误 | 原因：版本号（Version）错误。 解决方案：请确认接口的版本号，短信服务的API版本号（Version）为2017-05-25。 |
| InvalidAction.NotFound | 未找到指定的API，请检查您的URL和方法 | 原因：参数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 | 短链名不能超过13字符 | 原因：短链名不能超过13个字符。 解决方案：请根据短链规范重新创建。 |
| isv.SOURCEURL_OVER_LIMIT | 原始链接字符数量超过限制 | 原因：原始链接字符数量超过限制。 解决方案：重新创建判断字符长度是否符合平台规则。 |
| isv.SHORTURL_TIME_ILLEGAL | 短链有效期期限超过限制 | 原因：选择短链有效期限超过30天限制。 解决方案 ：请保证短链有效期输入在30天以内。更多信息，请参见短链服务。 |
| isv.PHONENUMBERS_OVER_LIMIT | 上传手机号个数超过上限 | 原因：单次调用上传手机号个数超过50000个上限。 解决方案：分多次调用短参生成接口，单次上传手机号个数不超过50000个。 |
| isv.SHORTURL_STILL_AVAILABLE | 原始链接生成的短链仍在有效期内 | 原因：原始链接生成的短链仍在有效期内，无需重复创建。 解决方案： * 待原始链接生成的短链失效或删除该短链后，重新创建。 * 使用新的原始链接，创建新的短链。 |
| isv.ERROR_EMPTY_FILE | 签名文件为空 | 原因：签名文件为空。 解决方案 ：检查签名文件，补充签名资质证明、授权书等相关文件截图。相关操作，请参见添加签名。 |
| isp.GATEWAY_ERROR | 调用发送应用模块失败 | 原因：调用发送应用模块失败。 解决方案：调用发送应用模块失败，请尝试重新发送。 |
| isv.ERROR_SIGN_NOT_DELETE | 审核中的签名，暂时无法删除 | 原因：签名正在审核中，暂时无法删除。 解决方案：请签名审核结束后，再删除对应签名。 |
| isv.ERROR_SIGN_NOT_MODIFY | 已通过的签名不支持修改 | 原因：已通过的签名不支持修改。 解决方案 ：请按签名规范，重新提交申请签名。具体操作，请参见添加签名。 |
| isv.ERROR_TEMPLATE_NOT_DELETE | 审核中的模板，暂时无法删除 | 原因：模板正在审核中，暂时无法删除。 解决方案：请模板审核结束后，再删除对应模板。 |
| isv.ERROR_TEMPLATE_NOT_MODIFY | 已通过的模板不支持修改 | 原因：已通过的模板不支持修改。 解决方案 ：请按模板规范，重新提交申请模板。更多信息，请参见公共内容规范。 |
| isv.SMS_OVER_LIMIT | 单日最多申请模板或签名100条 | 原因：您已超过单日最多申请模板或签名100条的上限。 解决方案 ：请您24小时后继续申请，或点击链接，打开钉钉扫码进入短信服务专属钉群处理。 |
| isv.CUSTOMER_REFUSED | 用户已退订推广短信 | 原因：该手机用户已退订推广短信。 解决方案：请尊重手机用户意愿，减少对该客户的推广短信发送。 |
| isv.SMS_TEST_SIGN_TEMPLATE_LIMIT | 测试模板和签名限制 | 原因：测试专用签名和模板必须结合使用。 解决方案 ：请使用短信服务提供的测试专用签名和测试专用模板。相关操作，请参见发送测试短信。 |
| isv.SHORTURL_DOMAIN_EMPTY | 短链创建失败 | 解决方案：请先提交该链接的一级域名报备。 |
| template_parameter_count_illegal | 验证码模板仅支持一个验证码作为变量 | 原因：在验证码模板变量中只能定义一个参数。 解决方案 ：请修改验证码模板变量。更多信息，请参见验证码模板规范。 |
| isv.SMS_TEST_TEMPLATE_PARAMS_ILLEGAL | 测试专用模板中的变量仅支持4~6位纯数字 | 解决方案：使用测试模板时变量仅支持传入4~6位纯数字。 |
| isv.SMS_TEST_NUMBER_LIMIT | 只能向已通过授权的手机号发送 | 解决方案：使用测试模板时仅支持向已授权信息的手机号发送。 |
| isv.SMS_SIGN_EMOJI_ILLEGAL | 签名不能包含emoji表情 | 解决方案：签名中不支持使用emoji表情。 |
| isv.SECURITY_FROZEN_ACCOUNT | 因该账号长时间未使用，出于对您的账号安全考虑，已限制您账号的短信发送 | 您若需要继续使用该账号，请与您的商务经理联系。 |
| IS_CLOSE | 短信下发时通道被关停 | 阿里云会自动剔除被关停通道，建议稍候重试。 |
| PARAMS_ILLEGAL | 参数错误 | 请检查短信签名、短信文案或手机号码等参数是否传入正确。 |
| MOBILE_NOT_ON_SERVICE | 停机、空号、暂停服务、关机、不在服务区 | 原因：运营商返回给阿里云平台该号码实时状态异常，如关机、停机、空号、暂停服务、不在服务区等。 解决方案：请核实接受手机号码状态是否正常。 |
| MOBILE_SEND_LIMIT | 单个号码日、月发送上限，流控超限，频繁发送超限 | 为了限制平台短信被恶意调用、在短时间内大量发起短信发送请求，阿里云平台和运营商都会有短信。 |
| MOBILE_ACCOUNT_ABNORMAL | 用户账户异常、携号转网、欠费等 | 建议检查号码状态, 确保号码状态正常后重新尝试。 |
| MOBILE_IN_BLACK | 手机号在黑名单 | 通常为手机号在运营商平台黑名单库中，一般是用户已退订此签名或命中运营商平台黑名单规则导致。 |
| MOBLLE_TERMINAL_ERROR | 手机终端问题、内存满、SIM卡满、非法设备等 | 建议核实终端设备状况、检查手机安全软件拦截记录、重启或者更换手机终端后再次尝试。 |
| CONTENT_KEYWORD | 内容关键字拦截 | 原因：运营商根据短信中有潜在风险或者高投诉的内容关键字进行自动拦截。 解决方案：请您检查发送的短信内容并相应修改文案。 |
| INVALID_NUMBER | 号码状态异常 | 原因：短信接收号码状态异常，如关机、停机、空号、暂停服务、不在服务区或号码格式错误。 解决方案：请您核实号码状态是否正常、号码格式是否正确。 |
| CONTENT_ERROR | 内容无退订 | 原因：营销内容中必需带退订信息。 解决方案：请您核实文案内容，增加退订信息，在营销短信结尾添加"回T退订"。 |
| REQUEST_SUCCESS | 请求成功（平台接到请求，但未接收到运营商侧的回执状态） | 原因：大概率是由于接收用户的状态异常导致。 解决方案：请您检查接收用户状态是否正常。 |
| SP_NOT_BY_INTER_SMS | 未开通国际短信 | 原因：收件人未开通接收国际短信功能。 解决方案：联系运营商开通国际短信功能后再进行短信发送。 |
| SP_UNKNOWN_ERROR | 运营商未知错误 | 该错误码表示阿里云平台接收到的运营商回执报告为未知错误，阿里云会定期与供应商核实更新。 |
| USER_REJECT | 接收用户已退订此业务或产品未开通 | 建议将此类接收用户剔除出发送清单。 |
| NO_ROUTE | 当前短信内容无可用通道发送 | 发送的业务场景属于暂时无法支持的场景。 |
| isv.UNSUPPORTED_CONTENT | 不支持的短信内容 | 原因：短信内容包含不支持的发送内容，如短信内容中包含签名符号【】或包含非常规字符。 解决方案 ：检查短信内容修改短信文案。短信模板内容规范，请参见公共内容规范。 |