RESTful API - getvalue
특정변수에 대하여 값을 요청
--------------------------------------------
Description
enuSpace 서버측에 데이터베이스의 변수값을 요청하는 API
--------------------------------------------
Request
HTTP Method : POST
URI : http://localhost:8080/getvalue?devicekey=043DFEDEFD&variable=A0
URI : http://localhost:8080/getvalue?tagid=@043DFEDEFD.A0
URI : http://localhost:8080/getvalue?page=main.svg&variable=ID_LOGIC.A0
Query Parameters
devicekey : device name
variable : device variable
or
tagid : database tagid
or
Example : ?devicekey=043DFEDEFD&variable=A0
Example : ?tagid=@043DFEDEFD.A0
Example : ?page=main.svg&variable=ID_LOGIC.A0
Content-Type : application/json; charset=UTF-8
--------------------------------------------
Response
Body
json file format
Body Example
{ “RESULT”:”OK”, “RESULT_CODE”:”RESULT_OK”, “DEVICE_KEY":”043DFEDEFD”, “VARIABLE":”A0”, "TAGID":"043DFEDEFD.A0", "TYPE":"int", "VALUE":"50" } |
--------------------------------------------
Sample Call
JavaScript
function getvalue() { var devicekey= document.getElementById("devicekey").value; var variable = document.getElementById("variable").value; var xmlHttp = new XMLHttpRequest(); var strUrl = "getvalue" ; var strParam= "devicekey="+devicekey + "&" + "variable="+ variable; xmlHttp.onreadystatechange=function() { if (xmlHttp.readyState==4 && xmlHttp.status==200) { var msg = xmlHttp.responseText;
var arr = JSON.parse(msg); if (arr.RESULT == "OK") { alert(arr.VALUE); } else { if (arr.RESULT_CODE == "CODE_VARIABLE_NOUT_FOUND" ) { alert(" 등록된 디바이스의 변수를 검색하지 못하였습니다."); } if (arr.RESULT_CODE == "CODE_UNKNOWN_DATATYPE" ) { alert("알수없는 데이터 타입니다.."); } } } }; xmlHttp.open("POST",strUrl,true); xmlHttp.setRequestHeader("Content-Type","application/x-www-form-urlencoded;charset=UTF-8"); xmlHttp.setRequestHeader("Cache-Control","no-cache, must-revalidate"); xmlHttp.setRequestHeader("Pragma","no-cache"); xmlHttp.send(strParam); } |
'enuSpace for mars(2017) > RESTful API and JSON' 카테고리의 다른 글
RESTful API - gethistoricaldata (enuSpace for mars) (0) | 2017.04.19 |
---|---|
RESTful API - setvalue_package (enuSpace for mars) (0) | 2017.04.19 |
RESTful API - getvalue_package (enuSpace for mars) (0) | 2017.04.19 |
RESTful API - setvalue (enuSpace for mars) (0) | 2017.04.19 |
RESTful API - requestpage (enuSpace for mars) (0) | 2017.04.19 |