访问方式:GET/POST (推荐POST)
http支持:支持https 与 http 两种访问,建议使用https
参数名 | 类型 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
apikey | String | 是 | 账户唯一标识符 | fe7e701f21645f35d62b95df8c85493f |
mobile | String | 是 | 接收的手机号,仅支持单号码发送 | 18968192967 |
content | String | 是 | 已审核短信模板 | 【签名】您正在注册逐鹿账号,验证码927257,如非本人操作请注意账号安全。 |
sendTs | Long | 否 | 用于指定营销短信定时发送 | 1525788234000 |
(1) 验证码短信需要先在后台新增模板,模板审核通过之后才可以发送,点击下面链接添加模板:http://console.dingdongcloud.com/#/console/verify/tpl
(2) 验证码数值需由您的系统生成,并替换掉{验证码}这个变量标签。
(3) 发送验证码短信时,无需指定模板,content参数直接传替换掉{验证码}标签的模版内容即可,平台会自动匹配审核过的模板。
(1) 通知短信需要先在后台新增模板,模板审核通过之后才可以发送,点击下面链接添加模板:http://console.dingdongcloud.com/#/console/notify/tpl
(2) 发送通知短信时,无需指定模版,content参数直接传替换掉{变量1...n}标签的模版内容即可,平台会自动匹配审核通过的模版
(1) 营销短信需要先在后台新增模板,模板审核通过之后才可以发送。点击以下链接申请:http://console.dingdongcloud.com/#/console/mkt/tpl
(2) 发送营销短信时,无需指定模版,content参数直接传替换掉{变量1...n}标签的模版内容即可,平台会自动匹配审核通过的模版
/**单条短信发送,智能匹配短信模板
* @param apikey 成功注册后登录叮咚云官网,进入后台可查看
* @param mobile 接收的手机号,仅支持单号码发送
* @param content 已审核短信模板
* @param sendTs 用于指定营销短信定时发送
* @return json格式字符串
*/
public static String singleSend(String apikey, String mobile, String content,Long sendTs) {
Map<String, String> params = new HashMap<String, String>();
params.put("apikey", apikey);
params.put("mobile", mobile);
params.put("content", content);
params.put("sendTs", sendTs);
return post("https://api.dingdongcloud.com/v2/sms/single_send", params);
}
名称 | 类型 | 描述 |
---|---|---|
code | Integer | 返回结果,code为1,表示成功,其他请参考返回值说明 |
msg | String | 返回结果说明 |
result | String | 此次发送的批次号,方便查询状态 |
{
"code": 1,
"msg": "成功",
"result": 311270218652635136
}