RESTful API - setvalue (enuSpace for mars)

RESTful API - setvalue

특정변수에 대하여 값을 설정 요청

--------------------------------------------

Description

enuSpace 서버측에 데이터베이스의 변수값을 설정 요청하는 API

--------------------------------------------

Request

HTTP Method : POST

URI : http://localhost:8080/setvalue?devicekey=043DFEDEFD&variable=A0&value=10

URI : http://localhost:8080/setvalue?tagid=@043DFEDEFD.A0&value=10

URI : http://localhost:8080/setvalue?page=main.svg&variable=ID_ARD.A0&value=10

Query Parameters

        devicekey : device name

        variable : device variable

        value : set value

        or

        tagid : database tagid

        value : set value

        or

        page : picture file name

        variable : variable name

        value : set value

Example : ?devicekey=043DFEDEFD&variable=A0&value=10

Example : ?tagid=@043DFEDEFD.A0&value=10

Example : ?page=main.svg&variable=ID_ARD.A0&value=10

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":"10" }

--------------------------------------------

Sample Call

JavaScript

function setvalue() { var devicekey= document.getElementById("devicekey").value; var variable = document.getElementById("variable").value; var setvalue = document.getElementById("setvalue").value; var xmlHttp = new XMLHttpRequest(); var strUrl = "setvalue" ; var strParam= "devicekey="+devicekey + "&" + "variable="+ variable + "&" + "value="+ setvalue;   xmlHttp.onreadystatechange=function() { if (xmlHttp.readyState==4 && xmlHttp.status==200)    {         var msg = xmlHttp.responseText; var arr = JSON.parse(msg); if (arr.RESULT == "OK") { location = "http://192.168.10.21:8080/main.html"; } 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); }