2.服务详解.doc

HTTP协议与ScadaCloud通信说明书(V) HTTP协议与ScadaCloud通信说明书VPage  PAGE 11 of  NUMPAGES 11 HTTP协议与ScadaCloud通信说明书(V) ScadaCloud Proxy协议说明书(V) 基于HTTP的API服务接口说明书(V) MinP Technology Address:深圳市龙岗区吉祥路风临国际A1404 Tel:0755Fax:0755 目 录  TOC \o 1-3 \h \z  HYPERLINK \l _Toc410114817 1. ScadaCloud APP服务介绍  PAGEREF _Toc410114817 \h 3  HYPERLINK \l _Toc410114818 1.1 简介  PAGEREF _Toc410114818 \h 3  HYPERLINK \l _Toc410114819 1.2 请求参数  PAGEREF _Toc410114819 \h 3  HYPERLINK \l _Toc410114820 1.3 举例  PAGEREF _Toc410114820 \h 4  HYPERLINK \l _Toc410114821 2. 服务详解  PAGEREF _Toc410114821 \h 5  HYPERLINK \l _Toc410114822 2.1 注册  PAGEREF _Toc410114822 \h 5  HYPERLINK \l _Toc410114823 2.2 登陆  PAGEREF _Toc410114823 \h 5  HYPERLINK \l _Toc410114824 2.3 读取数据点当前值  PAGEREF _Toc410114824 \h 5  HYPERLINK \l _Toc410114825 2.4 读取数据点历史数据  PAGEREF _Toc410114825 \h 6  HYPERLINK \l _Toc410114826 2.5 设置数据点  PAGEREF _Toc410114826 \h 7  HYPERLINK \l _Toc410114827 2.6 读取未确认事件  PAGEREF _Toc410114827 \h 7  HYPERLINK \l _Toc410114828 2.7 确认指定的事件  PAGEREF _Toc410114828 \h 8  HYPERLINK \l _Toc410114829 2.8 确认所有的事件  PAGEREF _Toc410114829 \h 8  HYPERLINK \l _Toc410114830 2.9 取最大的告警级别  PAGEREF _Toc410114830 \h 9  HYPERLINK \l _Toc410114831 注意事项  PAGEREF _Toc410114831 \h 10  HYPERLINK \l _Toc410114832 附录A：  PAGEREF _Toc410114832 \h 11 1. ScadaCloud APP服务介绍 1.1 简介 ScadaCloud为终端提供基于HTTP的接口：登陆，读取数据点的实时数据，读取数据点的历史数据，设置数据点,读取未确认事件，确认事件，确认所有未确认的事件，取当前最大告警级别。 ScadaCloud M2M与APP通信模型 参与ScadaCloud APP服务的实体有两个：ScadaCloud服务器,它提供基于HTTP的APP服务，链接为/ScadaCloud/api/ext.jsp；终端设备，如智能手机。 在本文档中，时间用距离1970年元月1日0时0分0秒的毫秒数来表示；二进制值用”true”和”false”来表示；多状态变量用由0~9组成的非负整数表示，如0，21，分别表示状态0和状态21；数字量的值用由-，0~9，.表示的浮点数，或科学计数法表示的浮点数。本文档对此约定不再另做说明。 API服务的返回值为UTF-8编码的字符串。 1.2 请求参数 使用GET方式时,格式是 /ScadaCloud/api/ext.jsp?service=SERVICEPARAM=VALUE 各参数的含义如下： 参数含义service服务名，当前提供的服务有：login，登陆服务；dpvalue，取数据点当前值；dp