# 接口文档

# 普通短信发送

# 协议说明

基于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=发送短信下行测试&timestamps=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

# 特殊短信批量发送

# 请求地址

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

# 响应格式

消息参数 类型 描述
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

# 请求结果

最近更新: 6/7/2024, 4:08:48 PM
点集科技   |