基于http的api服务接口说明书

《基于http的api服务接口说明书》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、HTTP协议与ScadaCloud通信说明书(V1.0.0.0)各专业全套优秀毕业设计图纸基于HTTP的API服务接口说明书(V1.0.0.0)MinPTechnologyAddress:深圳市龙岗区吉祥路风临国际A1404Tel:0755-84601839Fax:0755-84601830HTTP协议与ScadaCloud通信说明书V1.0.0.0Page11of11HTTP协议与ScadaCloud通信说明书(V1.0.0.0)目录1.SCADACLOUDAPP服务介绍31.1简介31.2请求参数31.3举例42.服务详解52.1注册52.2登陆52.

2、3读取数据点当前值52.4读取数据点历史数据62.5设置数据点72.6读取未确认事件72.7确认指定的事件82.8确认所有的事件82.9取最大的告警级别9注意事项10附录A：11HTTP协议与ScadaCloud通信说明书V1.0.0.0Page11of11HTTP协议与ScadaCloud通信说明书(V1.0.0.0)1.ScadaCloudAPP服务介绍1.1简介ScadaCloud为终端提供基于HTTP的接口：登陆，读取数据点的实时数据，读取数据点的历史数据，设置数据点,读取未确认事件，确认事件，确认所有未确认的事件，取当前最大告警级别。ScadaC

3、loudM2M与APP通信模型参与ScadaCloudAPP服务的实体有两个：ScadaCloud服务器,它提供基于HTTP的APP服务，链接为http://www.scadasaas.com/ScadaCloud/api/ext.jsp；终端设备，如智能手机。在本文档中，时间用距离1970年元月1日0时0分0秒的毫秒数来表示；二进制值用”true”和”false”来表示；多状态变量用由"0"~"9"组成的非负整数表示，如"0"，"21"，分别表示状态0和状态21；数字量的值用由"-"，"0"~"9"，"."表示的浮点数，或科学计数法表示的浮点数。本文档对

4、此约定不再另做说明。API服务的返回值为UTF-8编码的字符串。1.2请求参数使用GET方式时,格式是'http://www.scadasaas.com/ScadaCloud/api/ext.jsp?service=SERVICE&PARAM=VALUE.....各参数的含义如下：参数含义service服务名，当前提供的服务有：login，登陆服务；dpvalue，取数据点当前值；dphistory，取数据点的历史数据；setdp，设置数据点；pendingevents，取未确认事件；ackevents，确认事件；ackpendingevents，确认所有

5、未确认的事件；maxalarmlevel，取账户当前最大的报警级别。PARAM服务的参数；不同的服务参数的个数和含义不一样，详见后续说明。HTTP协议与ScadaCloud通信说明书V1.0.0.0Page11of11HTTP协议与ScadaCloud通信说明书(V1.0.0.0)1.3举例http://www.scadasaas.com/ScadaCloud/api/ext.jsp?service=login&user=12228074645@qq.com&password=123456它表示用户1228074645@qq.com登陆。HTTP协议与Sc

6、adaCloud通信说明书V1.0.0.0Page11of11HTTP协议与ScadaCloud通信说明书(V1.0.0.0)2.服务详解2.1注册链接格式：http://www.scadasaas.com/ScadaCloud/api/ext.jsp?service=register&username=USERNAME&password=PASSWORD&confirmpassword=PASSWORD参数说明：username表示用户名；password表示密码；confirmpassword表示确认密码返回值格式：如果注册成功，返回字符串“error

7、=OK”，其他字符串表示注册错误。2.2登陆链接格式：http://www.scadasaas.com/ScadaCloud/api/ext.jsp?service=login&username=USERNAME&password=PASSWORD参数说明：username表示登陆用户名；password表示登陆密码。返回值格式：如果登陆成功，返回字符串“OK”，其他字符串表示登陆错误。2.3读取数据点当前值参数格式：http://www.scadasaas.com/ScadaCloud/api/ext.jsp?service=dpvalue&dpxid=

8、DP_XID0&dpxid=DP_XID1……参数说明：dpxid