短信下发(相同内容多个号码)

2024-06-23 10:25| 来源: 网络整理| 查看: 265

短信下发

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

提交方式：

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

功能:

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

请求参数:参数值说明：以下json内容为提交请求数据格式 { "account":"dh****", "password":"e717ebfd5271ea4a98bd38653c01113d", "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-04-24 17:03 作者：夏亮

【本文地址】

公司简介

联系我们