AIO100是语音网关里的瑞士军刀!

AIO100-网络IP电话交换机语音网关

IPPBX语音网关里的瑞士军刀

当前位置: 主页 > AIO100设置使用 >

深简捷AIO100短信网关的HTTP开发接口使用说明

时间:2018-04-12 16:41来源:深简捷 作者:网关 点击:
深简捷面向有一定技术开发能力的用户而单独研发的短信(sms)接口采用了通用流行的HTTP URL形式,可以支持各种操作系统和开发语言,可以简单的把短信接口嵌入到您自己的系统中,快速
        深简捷面向有一定技术开发能力的用户而单独研发的短信(sms)接口采用了通用流行的HTTP URL形式,可以支持各种操作系统和开发语言,可以简单的把短信接口嵌入到您自己的系统中,快速拥有无线应用。

    一、短信接口方式

        通过HTTP URL方式提交请求消息,即简单的“name=value”格式,请求消息的格式稍后会详细描述。
        每次发送请求都有响应消息(响应返回格式为纯文本),来保证数据传输的完整性和安全性。
        考虑到AIO100短信网关的常用应用环境,暂无验证机制,请勿放在公网使用。

二、短信接口消息格式

  1. 发送短信
接口: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=你好!深简捷通信为您提供优质产品,电话0755-89801385
 
  1. 接收短信
接口:
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
 
  1. 清空短信接收列表(已读)
接口: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
 

附录1:PHP处理json格式的字符串的函数

json_decode
PHP json_decode() 函数用于对 JSON 格式的字符串进行解码,并转换为 PHP 变量。

语法

mixed json_decode ($json [,$assoc = false [, $depth = 512 [, $options = 0 ]]])

参数

  • json_string: 待解码的 JSON 字符串,必须是 UTF-8 编码数据
  • assoc: 当该参数为 TRUE 时,将返回数组,FALSE 时返回对象。
  • depth: 整数类型的参数,它指定递归深度
  • options: 二进制掩码,目前只支持 JSON_BIGINT_AS_STRING 。

实例

以下实例演示了如何解码 JSON 数据:
<?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)
织梦二维码生成器
顶一下
(0)
0%
踩一下
(0)
0%
------分隔线----------------------------
发表评论
请自觉遵守互联网相关的政策法规,严禁发布色情、暴力、反动的言论。
评价:
表情:
用户名: 验证码:点击我更换图片
栏目列表
推荐内容