一、短信接口方式
通过HTTP URL方式提交请求消息,即简单的“name=value”格式,请求消息的格式稍后会详细描述。
每次发送请求都有响应消息(响应返回格式为纯文本),来保证数据传输的完整性和安全性。
考虑到AIO100短信网关的常用应用环境,暂无验证机制,请勿放在公网使用。
二、短信接口消息格式
- 发送短信
接口:http://xxx.xxx.xxx.xxx/luci/gsm_send_msg
参数:
id //短信唯一标识id,长度不能大于32个字符,必 //选参数
to //短信发送目的号码,必选参数
content //短信发送内容,必选参数
返回值:
OK,表示成功
error msg,具体失败信息
例子:
id:00001
to: 13923809061
content: 你好!接收号码13923809061
(xxx.xxx.xxx.xxx表示深简捷AIO100的IP地址)
http://192.168.11.1/luci/gsm_send_msg?id=00001&to=13923809061&content=你好!测试
- 接收短信
接口:
http://xxx.xxx.xxx.xxx/luci/gsm_pull_msg
参数:
start_date //开始时间,格式:YYYY-MM-DD%20HH:MM:SS
end_date //结束时间,格式如上,可选参数
limit //拉取最大条数限制,可选参数
status //read或者unread,拉取的短信类型,已读还是未读。 //可选参数,默认未读
//成功拉取之后的未读短信会被标识为已读
返回值:
json串,{{from=””,date=””,content=””,status=””}...}
例子:
start_date: 2015-06-09%2017:00:00
end_date: 2015-06-10%2017:00:00
slot_id: 这个要填写0
(此处的参数可以自行调节)
http://192.168.11.1/luci/gsm_pull_msg?start_date=2015-06-09%2017:00:00&end_date=2015-06-10%2017:00:00
#暂不支持:客户端收到回执:(服务端收到回执确认之后,将会标记短信已被接收,不再被拉取到)
3.短信发送结果查询
接口:http://xxx.xxx.xxx.xxx/luci/gsm_check_msg
参数:id //发送短信携带的唯一id,可以多值,例如:”0123,0124”
(可以多次查询,无须回执确认)
返回值:json串,{{id=””,status=””},...}
例子:
id: 00001 (此处的id为 发送短信时携带的id)
http://192.168.11.1/luci/gsm_check_msg?id=00001
4.清空短信发送列表
接口:http://xxx.xxx.xxx.xxx/luci/gsm_empty_send_msg
参数:start_date //大于或等于开始时间,可选参数
end_date //小于或等于结束时间,可选参数
返回值:
OK,成功
error msg,具体失败信息
例子:
http://192.168.11.1/luci/gsm_empty_send_msg
- 清空短信接收列表(已读)
接口:http://xxx.xxx.xxx.xxx/luci/gsm_empty_recv_msg
参数:start_date //大于或等于开始时间,格式同上。可选参数
end_date //小于或等于结束时间,可选参数
返回值:
OK,成功
error msg,具体失败信息
例子:
http://192.168.11.1/luci/gsm_empty_recv_msg?start_date=2015-06-09%2017:00:00&end_date=2015-06-09%2017:59:59