深简捷面向有一定技术开发能力的用户而单独研发的短信(sms)接口采用了通用流行的HTTP URL形式,可以支持各种操作系统和开发语言,可以简单的把短信接口嵌入到您自己的系统中,快速拥有无线应用。一、短信接口方式每次发送请求都有响应消息(响应返回格式为纯文本),来保证数据传输的完整性和安全性。 考虑到AIO100短信网关的常用应用环境,暂无验证机制,请勿放在公网使用。 二、短信接口消息格式
参数: 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=你好!深简捷通信为您提供优质产品,电话0755-89801385
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
参数: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 附录1:PHP处理json格式的字符串的函数PHP json_decode() 函数用于对 JSON 格式的字符串进行解码,并转换为 PHP 变量。 语法mixed json_decode ($json [,$assoc = false [, $depth = 512 [, $options = 0 ]]]) 参数
实例<?php $json = '{"a":1,"b":2,"c":3,"d":4,"e":5}'; var_dump(json_decode($json)); var_dump(json_decode($json, true)); ?> object(stdClass)#1 (5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) } array(5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) } 深简捷AIO100短信网关的用途很多,其中挂机短信是比较常用的。 (责任编辑:admin) |