使用模板id下发

访问地址：http://www.dh3t.com/json/sms/Submit

提交方式：

支持https
只支持POST,该接口数据输入输出均采用json格式封装的字符串，编码（对整个请求的字符串编码）统一为UTF-8，采用post方式提交请求。

功能:

发送一条或者多条内容相同的短信（模板上传之后，把短信内容通过短信下发接口发送，我们后台也会自动匹配短信内容到相应模板，没有必要一定使用模板id下发）

请求参数:

参数值说明：以下json内容为提交请求数据格式

{
    "account":"dh****",
    "password":"0243614f784a8cfa94a94b85cbee7540",
    "msgid":"2c92825934837c4d0134837dcba00150",
    "phones":"1571166****",
    "template":{"id":"d65b268cba2243d8a4b15f22f9e847d8","variables":[{"name":"1","value":"内容1"},{"name":"2","value":"内容2"}]},
    "subcode":"",
    "sendtime":"201405051230"
}
参数名 必要性 说明
account 必填 用户账号
password 必填 密码，需采用MD5加密(32位小写)
phones 必填 接收手机号码，多个手机号码用英文逗号分隔，最多1000个，国际号码格式为+国别号手机号，号码示例：+85255441234，注意：1)国际手机号前如果带0会去0后下发 2)发送前账号需要开通国际功能
template 必填 短信模板格式，id对应模板id，variables对应模板内容的键值对集合，name对应变量内容序号（序号从1开始，必填），value对应具体内容；
msgid 选填 该批短信编号，需保证唯一，不填的话响应里会给一个系统生成的短信编号(32位UUID),填的话最长可填64位UUID
subcode 选填 短信签名对应子码(大汉三通提供)+自定义扩展子码(选填)，必须是数字，未填使用签名对应子码，无法前匹配签名对应子码则使用签名对应子码+所填子码，通常建议不填
sendtime 选填 定时发送时间，格式yyyyMMddHHmm，为空或早于当前时间则立即发送，定时时间不能超过1个月
params 选填 终端客户自定义参数params（总长度限制为1000），参数类型为Map，如果携带此参数会在状态报告里返回，示例："params":{"param1":"aaa","param2":"bbb"}（param1的位置如果写ctcTheme的话，ctcTheme的值会额外作为短信主题统计在大汉平台的短信主题统计里）
callbackurl 选填 个性回调地址，该条短信的状态报告会推送到该回调地址，注意：1)使用该参数需提前在客户服务群告知使用账号，我司需对账号配置方生效。2)回调地址固定的客户不需要使用此参数，可以直接根据推送接口进行对接 3)可以配置默认推送地址，不带callbackurl的情况下使用默认地址推送
moCallbackUrl 选填 个性回调地址，该条短信的上行会推送到该回调地址，注意：1)使用该参数需提前在客户服务群告知使用账号，我司需对账号配置方生效。2)回调地址固定的客户不需要使用此参数，可以直接根据推送接口进行对接 3)可以配置默认推送地址，不带moCallbackUrl的情况下使用默认地址推送

该响应为提交响应，发送到手机是否成功请获取状态报告确认

返回示例:

{
    "msgid":"f02adaaa99c54ea58d626aac2f4ddfa8",
    "result":"0",
    "desc":"提交成功",
    "failPhones":"12935353535,110,130123123"
}

返回参数说明:

参数名 说明
desc 状态描述
msgid 该批短信编号
result 该批短信提交结果；说明请参照：提交响应错误码
failPhones 如果提交的号码中含有错误（格式）号码将在此显示
文档更新时间: 2024-08-28 08:54   作者：夏亮