向指定手机号码发送模板短信，模板内可设置部分变量。使用前需要在阿里大鱼管理中心添加短信签名与短信模板。测试时请直接使用正式环境HTTP请求地址。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| extend | String | 可选 | 123456 | 公共回传参数，在“消息返回”中会透传回该参数；举例：用户可以传入自己下级的会员ID，在消息返回时，该会员ID会包含在内，用户可以根据该会员ID识别是哪位会员使用了你的应用 | |
| sms_type | String | 必须 | normal | 短信类型，传入值请填写normal | |
| sms_free_sign_name | String | 必须 | 阿里大鱼 | 短信签名，传入的短信签名必须是在阿里大鱼“管理中心-短信签名管理”中的可用签名。如“阿里大鱼”已在短信签名管理中通过审核，则可传入”阿里大鱼“（传参时去掉引号）作为短信签名。短信效果示例：【阿里大鱼】欢迎使用阿里大鱼服务。 | |
| sms_param | Json | 可选 | 短信模板变量，传参规则{"key":"value"}，key的名字须和申请模板中的变量名一致，多个变量之间以逗号隔开。示例：针对模板“验证码${code}，您正在进行${product}身份验证，打死不要告诉别人哦！”，传参时需传入{"code":"1234","product":"alidayu"} | ||
| rec_num | String | 必须 | 13000000000 | 短信接收号码。支持单个或多个手机号码，传入号码为11位手机号码，不能加0或+86。群发短信需传入多个号码，以英文逗号分隔，一次调用最多传入200个号码。示例：18600000000,13911111111,13322222222 | |
| sms_template_code | String | 必须 | SMS_585014 | 短信模板ID，传入的模板必须是在阿里大鱼“管理中心-短信模板管理”中的可用模板。示例：SMS_585014 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | BizResult | 0 | 返回值 |
|
|||
1 2 3 4 5 6 7 8 9 10 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);AlibabaAliqinFcUtilSmsNumSendRequest req = new AlibabaAliqinFcUtilSmsNumSendRequest();req.setExtend("123456");req.setSmsType("normal");req.setSmsFreeSignName("阿里大鱼");req.setSmsParamString("");req.setRecNum("13000000000");req.setSmsTemplateCode("SMS_585014");AlibabaAliqinFcUtilSmsNumSendResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 | <alibaba_aliqin_fc_util_sms_num_send_response> <result> <err_code>0</err_code> <model>134523^4351232</model> <success>false</success> <msg>成功</msg> </result></alibaba_aliqin_fc_util_sms_num_send_response> |
1 2 3 4 5 6 | <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 | 业务停机 | 登陆www.alidayu.com充值 |
| isv.PRODUCT_UNSUBSCRIBE | 产品服务未开通 | 登陆www.alidayu.com开通相应的产品服务 |
| isv.ACCOUNT_NOT_EXISTS | 账户信息不存在 | 登陆www.alidayu.com完成入驻 |
| isv.ACCOUNT_ABNORMAL | 账户信息异常 | 联系技术支持 |
| isv.SMS_TEMPLATE_ILLEGAL | 模板不合法 | 登陆www.alidayu.com查询审核通过短信模板使用 |
| isv.SMS_SIGNATURE_ILLEGAL | 签名不合法 | 登陆www.alidayu.com查询审核通过的签名使用 |
| isv.MOBILE_NUMBER_ILLEGAL | 手机号码格式错误 | 使用合法的手机号码 |
| isv.MOBILE_COUNT_OVER_LIMIT | 手机号码数量超过限制 | 批量发送，手机号码以英文逗号分隔，不超过200个号码 |
| isv.TEMPLATE_MISSING_PARAMETERS | 短信模板变量缺少参数 | 确认短信模板中变量个数，变量名，检查传参是否遗漏 |
| isv.INVALID_PARAMETERS | 参数异常 | 检查参数是否合法 |
| isv.BUSINESS_LIMIT_CONTROL | 触发业务流控限制 | 短信验证码，使用同一个签名，对同一个手机号码发送短信验证码，允许每分钟1条，累计每小时7条。 短信通知，使用同一签名、同一模板，对同一手机号发送短信通知，允许每天50条（自然日）。 |
| isv.INVALID_JSON_PARAM | JSON参数不合法 | JSON参数接受字符串值。例如{"code":"123456"}，不接收{"code":123456} |