最近更新时间:2023-05-08
接口地址:http:// 103.131.171.81:9090/sms/distinct/v1
请求方法:POST
接口描述:用于请求短信业务平台向不同用户发送不同的短信。
请求头里面需要设置传输格式:Content-type:application/json
参数名称 | 描述 | 是否必须 | 备注 |
appkey | 应用key | 是 | 参见“公共参数说明” |
appcode | 应用代码 | 是 | 参见“公共参数说明” |
sign | 签名验证MD5 | 是 | appkey+appsecret+timestamp经过md5加密后的32位16进制小写字符串(拼接过程不包括+) |
sms | sms[ ] | 是 | 个性化信息,短信条数不能超过1000条 |
templateCode | 模板标识 | 否 | 短信内容模板唯一标识 |
timestamp | 时间戳 | 是 | 时间戳(精确到毫秒),当前时间5分钟内请求有效 |
Sms参数结构如下:
参数名称 | 类型 | 是否必填 | 描述 |
phone | String | 是 | 手机号码 |
msg | String | 是 | templateCode模板标识为空时,该参数必填。 发送的短信内容长度不超过1000个字(包括1000字),每个英文或阿拉伯字符算1个字。 短信模板审核通过后才能进行发送 |
templateParma | String | 否 | templateCode模板标识不为空时,若短信内容存在变量,则该参数必传;若短信内容不存在变量,该参数不设置。 数据格式为JSON字符串 |
extend | String | 否 | 数字,如:001,119等。通道本身主叫号加上用户自己分配扩展号的总长度不能超过20位 |
请求参数信息说明:
{ "appkey": "test", "appcode": "test", "sign": "de7cb2fb99756c06214fc78252d36484", "timestamp": "1520496753938", "templateCode" :"IX2VpYGG", "sms": [ { "msg": "短信内容1", "phone": "15100000005", "extend": "", "templateParma" :"{\"user\":\"张三\",\"code\":\"265485\"}" }, { "msg": "短信内容2", "phone": "15100000055", "extend": "11" "templateParma" :"{\"user\":\"李四\",\"code\":\"985623\"}" } } |
请求成功响应信息示例如下。
{ "code": "00000", "desc": "提交成功", "result": [ { "status": "00000", "phone": "15100000055", "desc": "提交成功", "uid": "8b159b0036d0402e93b39fee102eedf2"
}, { "status": "00000", "phone": "15100000044", "desc": "提交成功", "uid": "8b159b0036d0402e93b39fee102ee587"
} ] } |
参数名称 | 类型 | 描述 |
code | String | 返回码 |
desc | String | 返回码描述 |
result | JSON数组 | 提交短信的详细状态数据 |
下表为result参数中的详细信息:
参数名称 | 类型 | 描述 |
status | String | 状态码 |
desc | String | 状态码描述 |
phone | String | 手机号码 |
uid | String | 提交返回的唯一标识(32位字符串,用于获取短信回执) |