# 接口文档
# 普通短信发送
# 协议说明
基于http协议,通过HTTP的 post Form 方式交换数据,推荐使用HTTP长连接。 双方需要保证数据传输的完整性和安全性。安全认证采用数字签名的方式,数字签名根据密码、手机号、时间戳32位MD5生成
# 字符编码
服务器请求和返回都采用UTF-8编码
# 请求URL
http://www.djzz.cn:8868/sms/mt
# 请求格式
| 消息参数 | 必填 | 描述 |
|---|---|---|
| account | 是 | 用户接口账号 |
| password | 是 | 数字签名:(接口密码、手机号、时间戳32位MD5加密生成) |
| mobile | 是 | 短信接收端手机号码集合,用半角逗号(英文逗号)分开,接口方式每批建议最多1000个号码。更多批量短信请至页面以文件方式提交手机号建议不重复,不强制限制。 |
| content | 是 | 短信内容,UTF-8编码字符串,单条通常为65汉字以内(根据签名规则不同),超过限制字数会被分拆,同时计费条数会根据最终拆分条数计算,具体由平台拆分结果确定. |
| timestamps | 是 | 时间戳,短信发送当前时间毫秒数,生成数字签名用,有效时间1分钟,强烈建议实时生成 |
| extNumber | 否 | 扩展号码。长度不大于4的数字组成 |
| extInfo | 否 | 扩展字符串。在各类回执中会返回。规则(由字母数字 _组成的长度不大于50的字符串) |
示例
account=570061&password=fa246d0262c3925617b0c72bb20eeb1d&mobile=13788888888&content=发送短信下行测试×tamps=1444806441928
# 响应格式
| 消息参数 | 类型 | 描述 |
|---|---|---|
| Rets | Object[] | 结果返回集合,每个提交手机号对应以下子元素 |
| Rspcode | Int | 响应码见附录- respcode |
| Msg_Id | String | 信息标识,用于对应状态报告响应码不成功时无此内容 |
| Mobile | String | 手机号 |
| ExtInfo | String | 扩展信息为空时无这个字段 |
| Fee | Int | 计费数 |
# 返回报文示例
{
"Rets": [
{
"Rspcode": 0,
"Msg_Id": " 114445276129660989",
"Mobile": "18600000000",
"ExtInfo": "NO234",
"Fee": 1
},
{
"Rspcode": 0,
"Msg_Id": " 114445276129660991",
"Mobile": "13910101010",
"ExtInfo": "NO234",
"Fee": 1
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 特殊短信批量发送
# 请求地址
http://www.djzz.cn:8868/sms/multimt
# 请求格式
| 消息参数 | 是否必填 | 描述 |
|---|---|---|
| account | 是 | 用户接口账号 |
| password | 是 | 数字签名:(接口密码、手机号、时间戳32位MD5加密生成) |
| objjson | 是 | 多功能短信发送内容 json格式字符串,格式见下表 |
| timestamps | 是 | 时间戳,短信发送当前时间毫秒数,生成数字签名用,有效时间1分钟,强烈建议实时生成 |
| sheduledTime | 否 | 定时任务,定时时间点 时间戳 毫秒值 |
| ignoreDup | 否 | 1 表示忽略重复号码 |
示例
password=48b2c7fedbccb1453529328e56308bcd&account=yali001×tamps=1489932876685&sheduledTime=1490012876685&objjson={"content":"尊敬的#code#,您的余额为#code#","mobileParms":[{"parms":["用户0","000"],"mobile":"13710000000"},{"parms":["用户1","100"],"mobile":"13710000001"},{"parms":["用户2","200"],"mobile":"13710000002"},{"parms":["用户3","300"],"mobile":"13710000003"},{"parms":["用户4","400"],"mobile":"13710000004"}]}
# Objjson 对象格式
| 消息参数 | 类型 | 描述 |
|---|---|---|
| Content | String | 短信内容,变量以 #code#代替 |
| mobileParms | Object[] | 手机号,内容变量参数,为了发送效率,建议不要超过2000个每批 |
| Mobile | String | 接收手机号 |
| Parms | String集合 | 参数集合,参数个数0 -- 10 |
示例
{
"content": "尊敬的#code#,您的余额为#code#",
"mobileParms": [
{
"parms": [
"用户0",
"000"
],
"mobile": "13710000000"
},
{
"parms": [
"用户1",
"100"
],
"mobile": "13710000001"
},
{
"parms": [
"用户2",
"200"
],
"mobile": "13710000002"
},
{
"parms": [
"用户3",
"300"
],
"mobile": "13710000003"
},
{
"parms": [
"用户4",
"400"
],
"mobile": "13710000004"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# 响应格式
| 消息参数 | 类型 | 描述 |
|---|---|---|
| Rets | Object[] | 结果返回集合,每个提交手机号对应以下子元素 |
| Rspcode | int | 响应码见附录- respcode |
| Msg_Id | String | 信息标识,用于对应状态报告响应码不成功时无此内容 |
| Fee | int | 计费数,计费数以运营商网关计费为准 |
示例
{
"Rets": [
{
"Rspcode": 0,
"Msg_Id": " 514899328243063027",
"Mobile": "13710000002",
" Fee ": -1
},
{
"Rspcode": 0,
"Msg_Id": " 514899328243063028",
"Mobile": "13710000002",
" Fee ": -1
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16