文档

API错误码

更新时间:

调用短信服务API接口失败时会返回错误码,请根据错误码和错误信息排查问题。

错误码(Code)

错误信息(Message)

原因及解决方案

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

在账号下找不到对应模板

原因

  • 传入的模板Code有误。

  • 传入的模板格式有误。

解决方案:

  • 请检查AccessKey账号和模板是否属于同一个账号。

    若账号模板属于同一账号,请登录短信服务控制台,在模板管理页面查看此模板是否审核通过,若未通过审核,建议模板审核通过后再使用此模板。

  • 请检查模板格式。更多模板规范请参见短信模板规范

    模板Code是否含有空格,若无空格,检查模板传入的变量值个数和模板实际的变量个数是否相符,若变量个数相符,检查模板传入的变量名称是否与模板对应变量的名称相符。

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

调用接口时参数PhoneNumbers中指定的手机号码数量超出限制。

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

解决方案

  • 请将手机号码数量限制在规定范围以内。

  • 各接口参数PhoneNumbers数量限制如下:

    • SendSms接口、SendCardSms接口:上限为1000个手机号码;

    • SendBatchSms接口、SendBatchCardSms接口:最多可以向100个手机号码发送短信。

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

内容无退订

原因:推广短信内容中必须带退订信息。

解决方案:请您核实文案内容,增加退订信息,在推广短信结尾添加“拒收请回复R”。更多详情请参见推广短信模板规范

REQUEST_SUCCESS

请求成功(平台接到请求,但未接收到运营商侧的回执状态)

原因:大概率是由于接收用户的状态异常导致。

解决方案:请您检查接收用户状态是否正常。

SP_NOT_BY_INTER_SMS

未开通国际短信

原因:收件人未开通接收国际短信功能。

解决方案:联系运营商开通国际短信功能后再进行短信发送。

SP_UNKNOWN_ERROR

运营商未知错误

该错误码表示阿里云平台接收到的运营商回执报告为未知错误,阿里云会定期与供应商核实更新。

USER_REJECT

接收用户已退订此业务或产品未开通

建议将此类接收用户剔除出发送清单。

NO_ROUTE

当前短信内容无可用通道发送

发送的业务场景属于暂时无法支持的场景。

isv.UNSUPPORTED_CONTENT

不支持的短信内容

原因:短信内容包含不支持的发送内容,如短信内容中包含繁体字、emoji表情符号、 其他非常用字符(例如【】、〖〗、『』、「」、 m²、 • 、①、★、※、→、 、❤、™)。

解决方案:检查短信内容修改短信文案,去掉不支持的文字符号,更详细的短信模板内容规范,请参见短信模板规范

isv.SMS_CONTENT_MISMATCH_TEMPLATE_TYPE

短信内容和模板属性不匹配

原因:通知模板发送推广营销意义的文案无法支持。

解决方案:模板请加上“拒收请回复R”然后用推广短信的模板发送短信。

相关文档

  • 您可以在OpenAPI界面查看更多错误码信息,还可以对错误码进行问题诊断。

  • 短信发送状态回执错误码,请参见回执错误码

  • 本页导读 (1)
文档反馈