短信业务 ——HTTP接口文档
1. 用户提交
请求地址:http://ip:port/sms/sendBatch
1.1 接口公共参数说明
参数名称 | 参数类型 | 是否必须 | 参数描述 |
---|---|---|---|
appId | String | 是 | 用户Appid |
timestamp | String | 是 | 14位-当前时间戳 格式:yyyyMMddHHmmss |
sign | String | 是 | 32位-签名 格式:md5(appId+ secretKey +timestamp) |
mobiles | String | 是 | 手机号(多个,用逗号分隔,最多1000个) |
content | String | 是 | 短信内容采用utf-8URLEncoder.encode(content, “UTF-8”) |
schTime | String | 否 | 定时发送时间(选填,定时时间在90天内)格式:yyyyMMddHHmmss 14位 如果不填,则为即时发送 |
batchId | String | 是 | 自定义消息ID(最长64位) |
addserial | String | 否 | 扩展码,最长支持12位,如果超过,则会截取。根据我司建议位数提交 |
请求示例
http://ip:port/sms/sendBatch?appId=LHW-SMS-2XG&sign=e0be54f095fc72ee82a70dae644e7a0&mobiles=13000000000,15000000000&content=%E3%80%90%E9%B8%BF%E8%81%94%E4%B9%9D%E4%BA%94%E3%80%91%E6%82%A8%E5%A5%BD%EF%BC%8C%E6%82%A8%E7%9A%84%E9%AA%8C%E8%AF%81%E7%A0%81%E6%98%AF252111×tamp=20190409153345&schTime=&batchId=101&addserial=3
1.2 接口通用返回值说明
1.2.1 返回参数
参数名称 | 参数类型 | 参数描述 | 示例值 |
---|---|---|---|
code | String | 值为 SUCCESS 时说明提交成功 | 详细见响应示例 |
data | String | 结果内容 json格式 |
响应示例
{
"code": "SUCCESS",
"data": ""
}
2.个性(批量)短信提交
2.1 用户
2.1.1 用户批量提交
接口说明
如需要大批量发送个性短信,减少HTTP请求次数,时间,可用此接口进行发送。可定时发送,定时本批提交的所有的个性短信的发送时间
URL
http:///ip:port:8200/sms/send
请求方式
get
参数请求格式
url
请求参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
---|---|---|---|
appId | String | 是 | 用户Appid |
sign | String | 是 | 签名格式:md5(appId+ secretKey + timestamp) 32位 |
【手机号与内容】 | String | 是 | 手机号=内容(必填)【可多个】,每次提交最多1000个以手机号为参数名,内容为参数值传输 如:18001000000=端午节快乐 |
schTime | String | 否 | 定时发送时间(选填,定时时间在90天之内)格式:yyyyMMddHHmmss 14位 如果不填,则为即时发送 |
batchId | String | 是 | 自定义消息ID(最长64位) |
addserial | String | 否 | 扩展码,最长支持12位,如果最终号码长度超长,会截取扩展码,请根据我司建议位数提交 |