文档中心 > API类目 > 阿里通信API

alibaba.aliqin.ta.sms.num.send (短信发送)

短信发送

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rec_num String 必须 13000000000 接收号码
sms_template_code String 必须 SMS_001 短信模板CODE
extend String 可选 123456 公共回传参数
sms_free_sign_name String 必须 短信签名 短信签名
sms_param Json 可选 短信模板变量,AckNum是变量参数
sms_type String 必须 normal 类型,normal:短信
extend_code String 可选 1234 商家自定义扩展码
extend_name String 可选 1234 商家自定义扩展名,例如店铺nick

响应参数

名称 类型 示例值 描述
result BizResult 返回结果
  • └ model
  • String
  • 134523^4351232
  • 返回结果
  • └ msg
  • String
  • 成功
  • 返回信息描述
  • └ success
  • Boolean
  • false
  • true表示成功,false表示失败
  • └ err_code
  • String
  • 0
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinTaSmsNumSendRequest req = new AlibabaAliqinTaSmsNumSendRequest();
req.setRecNum("13000000000");
req.setSmsTemplateCode("SMS_001");
req.setExtend("123456");
req.setSmsFreeSignName("短信签名");
req.setSmsParamString("");
req.setSmsType("normal");
req.setExtendCode("1234");
req.setExtendName("1234");
AlibabaAliqinTaSmsNumSendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_aliqin_ta_sms_num_send_response>
    <result>
        <model>134523^4351232</model>
        <msg>成功</msg>
        <success>false</success>
        <err_code>0</err_code>
    </result>
</alibaba_aliqin_ta_sms_num_send_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.OUT_OF_SERVICE 业务停机 请充值
isv.PRODUCT_UNSUBSCRIBE 产品服务未开通 开通相应的产品服务
isv.ACCOUNT_NOT_EXISTS 账户信息不存在 入驻开户
isv.ACCOUNT_ABNORMAL 账户信息异常 联系技术支持
isv.MOBILE_NUMBER_ILLEGAL 号码格式不合法 使用合法的手机号码
isv.MOBILE_COUNT_OVER_LIMIT 批量号码个数超过限制 批量号码个数请不要超限
isv.SMS_TEMPLATE_ILLEGAL 短信模板不合法 请使用合法的短信模板
isv.SMS_SIGNATURE_ILLEGAL 短信签名不合法 请使用合法的短信签名
isv.TEMPLATE_MISSING_PARAMETERS 短信模板变量缺少参数 检查短信模板变量参数是否漏传
isv.INVALID_PARAMETERS 参数异常 检查参数是否合法
isv.BUSINESS_LIMIT_CONTROL 触发业务流控限制 短信验证码,使用同一个签名,对同一个手机号码发送短信验证码,允许每分钟1条,累计每小时7条。 短信通知,使用同一签名、同一模板,对同一手机号发送短信通知,允许每天50条(自然日)。

API工具

如何获得此API

FAQ

返回
顶部