单条发送接口

URL: https://api.dingdongcloud.com/v2/sms/single_send

请求

访问方式: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 此次发送的批次号,方便查询状态

Json返回示例

{
  "code": 1,                     
  "msg": "成功",                 
  "result": 311270218652635136                 
}

17098409373

常见售前问题:

可以发哪些类型短信?
叮咚云短信的价格?
如何接入叮咚云验证码/通知短信?

》查看更多常见问题《