本接口提供了HTTP和WebService两种实现方式。
对于采用HTTP协议的用户,出于数据安全性和数据容量考虑,建议采用http中的Post方法连接Api地址进行数据传输。
提交地址:http://118.178.228.184:9001/smsSend.do
send接口提交方式:POST/GET
功能:发送短信
输入参数 | 描述 |
---|---|
username | 用户名(必填) |
password | 密码(必填)MD5(username+MD5(pwd)) Username为用户名,pwd为明文密码,使用32位小写MD5加密 |
mobile | 手机号,多个手机号为用半角 , 分开,如 13899999999, 13688888888(最大提交1W个,GET方式最多500个,必填) |
content | 发送内容(必填) |
dstime | 定时时间,为空时表示立即发送(选填) 格式:yyyy-MM-dd HH:mm:ss |
ext | 用户自定义扩展(选填) 需要向客户经理提交开通扩展签名 |
msgid | 客户自定义消息id(选填) |
msgfmt | 提交消息编码格式(选填) 置空时默认是UTF-8 |
样例:
http://118.178.228.184:9001/smsSend.do?username=jckj&password;=MD5(jckj+MD5(123456))&mobile;=13911000000&content;=中国
其中: content的处理方式
String content = "汉字";
content = URLEncoder.encode(content, "UTF-8");
提交地址:http://118.178.228.184:9001/sendData.do
send接口提交方式:POST
功能:提交个性短信
输入参数 | 描述 |
---|---|
username | 用户名(必填) |
password | 密码(必填)MD5(username+MD5(pwd)) Username为用户名,pwd为明文密码,使用32位小写MD5加密 |
mobile | 手机号,多个手机号为用半角 , 分开,如 13899999999, 13688888888(最大提交1W个,GET方式最多500个,必填) |
content | 发送内容(必填) |
dstime | 定时时间,为空时表示立即发送(选填) 格式:yyyy-MM-dd HH:mm:ss |
ext | 用户自定义扩展(选填) 需要向客户经理提交开通扩展签名 |
msgid | 客户自定义消息id(选填) |
msgfmt | 提交消息编码格式(选填) 置空时默认是UTF-8 |
样例:
String content1 = "xu测试信息1%";
String content2 = "xx测试信息2%";
String content3 = "ww测试信息3%";
String charset = "UTF-8";
(1)内容单独编码后用英文,隔开变成串
String content = URLEncoder.encode (content1,charset) +","+ URLEncoder.encode(content2, charset)+","+URLEncoder.encode(content3,charset);
(2)对整个串进行二次编码
URLEncoder.encode(URLEncoder.encode(content,charset), charset))
提交地址:http://118.178.228.184:9001/balanceQuery.do
Finance接口提交方式:POST/GET
功能:查询短信剩余数量
输入参数 | 描述 |
---|---|
username | 用户名(必填) |
password | 密码(MD5(username+MD5(password)))(必填) |
样例:
http://118.178.228.184:9001/balanceQuery.do?username=userccc&password=MD5(user+MD5(XXXX))
输入参数 | 描述 |
---|---|
XXXXX | XXXXX代表该产品的剩余条数 |
-1 | 用户名或密码不正确 |
-2 | 必填选项为空 |
提交地址:http://118.178.228.184:9001/passwordUpade.do
接口提交方式:POST/GET
功能:更新密码
输入参数 | 描述 |
---|---|
username | 用户名(必填) |
password | 密码(MD5(username+MD5(password)))(必填) |
newpassword | 新密码 |
推送方式:http post
推送条数:多条
推送格式:report=号码|状态码|短信ID|扩展码|接收时间;号码|状态码|短信ID|扩展码|接收时间
说明:多条报告中间用英文分号(;)隔开,接收成功后对放接口必须回复0,否则会多次重复推送。
输入参数 | 描述 |
---|---|
DELIVRD | 状态成功 |
UNDELIV | 状态失败 |
EXPIRED | 因为用户长时间关机或者不在服务区等导致的短消息超时没有递交到用户手机上 |
REJECTD | 消息因为某些原因被拒绝 |
MBBLACK | 黑号 |
推送方式:http post
推送条数:多条
推送格式:deliver=内容|扩展码|编码格式|号码|用户名|时间
默认编码格式为UTF-8。如内容乱码,请使用解码URLDecoder.decode(strTest,"UTF-8");
说明:多条报告中间用英文分号(;)隔开,接收成功后对放接口必须回复0,否则会多次重复推送。
© 2024 南京鼎山信息科技有限公司 版权所有 | 苏ICP备13041208号-1