1 协议说明
1.1 HTTP协议
根据客户需求,国宇提供二次开发接口。采用HTTP的POST或GET方式进行消息的下发。在使用接口时,以如下形式进行调用。
http://host/xx.aspx?xxx=111&yyy=1235&……
注意事项:
1.短信内容中的中文字符支持GB码和UTF-8
请求页面分别为:
http://www.gysoft.cn/smspost/send.aspx GB码
http://www.gysoft.cn/smspost_utf8/send.aspx utf8码
3.返回结果为纯文本方式。
4.在返回结果中,需要去除前后多余的空白行。
5.用于文本分割的分割符号均为英文字符,比如逗号和分号。
6.请求的参数名为小写
7.汉字等特殊字符采用编码方式传输 编码实例
源字符串 |
abcABC!!&@#中国 123%* |
编码字符串(gb) |
abcABC!%a3%a1%26%40%23%d6%d0%b9%fa+123%25* |
编码字符串(utf8) |
abcABC!%ef%bc%81%26%40%23%e4%b8%ad%e5%9b%bd+123%25* |
2 消息发送
2.1 发送
2.2.1 获得短信余额数量
入口地址:http://www.gysoft.cn/smspost_utf8/havenum.aspx
参数说明:
参数 |
长度(字节) |
类型 |
说明 |
username |
50 |
字符串 |
用户名 |
password |
50 |
字符串 |
用户密码 |
返回结果:
值 |
类型 |
说明 |
100 |
字符串 |
成功 账户还剩余100可发送 直接返回剩余条数 |
<0 |
字符串 |
失败 |
发送实例:
http://www.gysoft.cn/smspost_utf8/havenum.aspx?username=YourName&password=pwd
2.2.2 发送消息
入口地址:http://www.gysoft.cn/smspost_utf8/send.aspx
参数说明(如果有汉字或特殊字符要编码):
参数 |
长度(字节) |
类型 |
说明 |
username |
50 |
字符串 |
用户名 |
password |
50 |
字符串 |
用户密码 |
mobile |
11 |
字符串 |