接口地址
|
https://smsapi.izjun.com:8443/
|
|
# 1.前言
|
本协议基于HTTP服务，使用POST请求方式，请求和应答均为JSON格式数据.。
|
字段命名方式：驼峰法。
|
统一请求和响应编码：UTF-8
|
统一请求Header内容：Content-Type:application/json
|
请使用接口网关地址替换文档中的服务器地址：http://{address:port}/sms
|
sign参数计算规则：多个指定参数值组合成字符串后计算MD532位小写结果
|
要求：MD5(userName+timestamp+MD5(password))
|
假设：userName(帐号名)=test
|
password(帐号密码)=123
|
timestamp=1596254400000
|
计算：MD5(password)=202cb962ac59075b964b07152d234b70
|
组合字符串：test1596254400000202cb962ac59075b964b07152d234b70
|
sign结果：MD5(组合字符串)=e315cf297826abdeb2092cc57f29f0bf
|
|
# 2.短信批量发送接口
|
## 2.1调用地址
|
地址：http://{address:port}/sms/api/sendMessageMass
|
请求方法：POST
|
|
## 2.2请求包头定义
|
Accept:application/json
|
Content-Type:application/json;charset=utf-8
|
|
## 2.3请求参数
|
参数名 类型 必填 说明
|
userName String 是 帐号用户名
|
content String 是 短信内容
|
phoneList [Array] 是 发送手机号码，JSON数组格式。
|
timestamp Long 是 当前时间戳，精确到毫秒。例如2020年8月1日12:00:00时间戳为：1596254400000
|
sign String 是 由以下参数值组合成字符串并计算MD5值，参考详细规则 计算：MD5(userName+timestamp+MD5(password))
|
|
## 2.4响应结果
|
参数名 类型 说明
|
code Integer 处理结果，0为成功，其他失败，详细参考响应状态码
|
message String 处理结果描述
|
msgId Long 当code=0时，系统返回唯一消息Id
|
smsCount Integer 当code=0时，系统返回消耗计费总数
|
|
## 2.5请求示例
|
发送请求：
|
POSThttp://{address:port}/sms/api/sendMessageMass
|
Accept:application/json
|
Content-Type:application/json;charset=utf-8
|
{
|
"userName":"test",
|
"content":"【签名】您的验证码是123456",
|
"phoneList": ["13500000001","13500000002","13500000003"],
|
"timestamp":1596254400000,
|
"sign":"e315cf297826abdeb2092cc57f29f0bf"
|
}
|
响应结果：
|
{
|
"code":0,
|
"message":"处理成功",
|
"msgId":123456,
|
"smsCount":3
|
}
|
