接口说明:接口编码方式采用统一的UTF-8,请求方式采用HTTP REST,支持GET/POST方式
1 短信发送接口
用户客户端向网关提交短信
1.1. 请求地址
https://host/sms(使用https需要联系供应商是否支持)
请求方式可以 POST 和 GET方式,建议采用POST方式
1.2. 参数说明
参数需要 URLENCODE,编码方式采用UTF-8
http://host:port/sms?action=send&account=账号&password=密码&mobile=15023239810,13527576163&content=内容&extno=1069012345&rt=json
1.3. 响应数据
"status": "0",
"balance": -153278040,
"list": [
{
"mid": "4C2CA88382720003",
"mobile": "18983437010",
"result": 0
},
{
"mid": "4C2CA88382720004",
"mobile": "18983437011",
"result": 0
}
]
}
字段 | 说明 |
status | 请求结果,具体参见STATUS错误代码表 |
balance | 当前账户余额,单位厘 |
list | 短信提交响应列表 |
mid | 消息ID(用于状态报告匹配) |
mobile | 手机号码 |
result | 短信提交错误代码,参见RESULT错误代码表 |
2.点对点发送
用于客户端向网关提交点对点短信,即一个号码一个内容的短信
2.1. 接口请求地址
https://host/sms(使用https需要联系供应商是否支持)
请求方式可以 POST 和 GET方式,建议采用POST方式
2.2. 参数定义
参数需要 URLENCODE,编码方式采用UTF-8
http://192.168.1.4:7822/sms?action=p2p&rt=json&account=922011&password=123456&mobileContentList=13800000001%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b91%0d13800000002%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b92%0d13800000003%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b93%0d13800000004%23%e4%b8%8b%e5%8f%91%e5%86%85%e5%ae%b94%0d&extno=10690231221
2.3. 响应数据
"status": "0",
"balance": -153278280,
"list": [
{
"mid": "4C372C4382720007",
"mobile": "13800000001",
"result": 0
},
{
"mid": "4C372C4382720008",
"mobile": "13800000002",
"result": 0
},
{
"mid": "4C372C4382720009",
"mobile": "13800000003",
"result": 0
},
{
"mid": "4C372C438272000A",
"mobile": "13800000004",
"result": 0
}
]
}
字段 | 说明 |
status | 请求结果,具体参见STATUS错误代码表 |
balance | 当前账户余额,单位厘 |
list | 短信提交响应列表 |
mid | 消息ID(用于状态报告匹配) |
mobile | 手机号码 |
result | 短信提交错误代码,参见RESULT错误代码表 |
3.余额查询接口
用于客户端查询当前账户余额
3.1.请求地址
https://host/sms(使用https需要联系供应商是否支持)
请求方式可以 POST 和 GET方式,建议采用POST方式
3.2.参数说明
参数需要 URLENCODE,编码方式采用UTF-8
参数名称 | 含义 | 说明 |
action | 请求动作 | 设置为固定的:balance |
account | 用户帐号 | 用户帐号,由系统管理员 |
password | 帐号密码 | 非加密:password 加密:MD5(password) |
rt | 响应数据类型 | json |
http://host:port/sms?action=balance&account=账号&password=密码&rt=json
3.3.响应数据
{"status":0,"balance":-153278040,"chargeType":"POSTCHARGE"}
字段 | 说明 |
status | 请求结果,具体参见STATUS错误代码表 |
balance | 当前账户余额,单位厘 |
chargeType | POSTCHARGE=后付费 PRECHARGE=预付费 |