短信下发

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

提交方式：

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

功能:

发送一条或者多条内容相同的短信

请求参数:

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

{
    "account":"dh****",
    "password":"0243614f784a8cfa94a94b85cbee7540",
    "msgid":"2c92825934837c4d0134837dcba00150",
    "phones":"1571166****,1571165****",
    "content":"您好，您的手机验证码为：430237。",
    "sign":"【****】",
    "subcode":"",
    "sendtime":"201405051230"
}
参数名 必要性 说明
account 必填 用户账号
password 必填 密码，需采用MD5加密(32位小写)
phones 必填 接收手机号码，多个手机号码用英文逗号分隔，最多1000个，国际号码格式为+国别号手机号，号码示例：+85255441234，注意：1)国际手机号前如果带0会去0后下发 2)发送前账号需要开通国际功能
content 必填 短信内容，最多1000个汉字，内容中不要出现【】[]这两种方括号，该字符为签名专用
msgid 选填 该批短信编号，需保证唯一，不填的话响应里会给一个系统生成的短信编号(32位UUID),填的话最长可填64位UUID
sign 选填 短信签名，该签名需要提前报备，生效后方可使用，不可修改，不填使用默认签名，示例如：【大汉三通】
subcode 选填 短信签名对应子码(大汉三通提供)+自定义扩展子码(选填)，必须是数字，未填使用签名对应子码，无法前匹配签名对应子码则使用签名对应子码+所填子码，通常建议不填
sendtime 选填 定时发送时间，格式yyyyMMddHHmm，为空或早于当前时间则立即发送，定时时间不能超过1个月
params 选填 终端客户自定义参数params（总长度限制为1000），参数类型为Map，如果携带此参数会在状态报告里返回,不能作为模板变量使用，示例："params":{"param1":"aaa","param2":"bbb"}（param1的位置如果写ctcTheme的话，ctcTheme的值会额外作为短信主题统计在大汉平台的短信主题统计里）
urlReplace 选填 是否支持长链接替换下发，填true时内容中查找符合规则（以http或https或ftp或weixin://开头，长度大于14位且长链接两头有空格或\t或换行）的第一个长链接进行替换（一个号码对应一个短链接）后下发。(若短信内容存在多个url地址,将会以第一个url替换)
callbackurl 选填 个性回调地址，该条短信的状态报告会推送到该回调地址，注意：1)使用该参数需提前在客户服务群告知使用账号，我司需对账号配置方生效。2)回调地址固定的客户不需要使用此参数，可以直接根据推送接口进行对接 3)可以配置默认推送地址，不带callbackurl的情况下使用默认地址推送
moCallbackUrl 选填 个性回调地址，该条短信的上行会推送到该回调地址，注意：1)使用该参数需提前在客户服务群告知使用账号，我司需对账号配置方生效。2)回调地址固定的客户不需要使用此参数，可以直接根据推送接口进行对接 3)可以配置默认推送地址，不带moCallbackUrl的情况下使用默认地址推送

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

返回示例:

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

返回参数说明:

参数名 说明
desc 状态描述
msgid 该批短信编号
result 该批短信提交结果；说明请参照：提交响应错误码
failPhones 如果提交的号码中含有错误（格式）号码将在此显示
taskid 有长链接地址替换时返回该参数，短链接的任务编号

Postman 请求示例截图

文档更新时间: 2024-08-28 08:52   作者：夏亮