组态王RESTful协议WebService

一、RESTful协议WebService

1、GetTaglist()：

• 该函数的功能是获取函数变量列表，返回值是json串，用户根据返回的json串自行解析成结构体，结构体成员包含变量名、变量ID、变量类型、变量值。

- 例: get请求 http://localhost:8089/GetTaglist

返回值: {
"KvTags" : [
{
"VarValue" : 0,
"nVarID" : 21,
"nVarType" : 4,
"strVarName" : "灯1"
},
{
"VarValue" : 0,
"nVarID" : 22,
"nVarType" : 4,
"strVarName" : "开关按钮1"
},
{
"VarValue" : 0,
"nVarID" : 23,
"nVarType" : 4,
"strVarName" : "灯2"
},
{
"VarValue" : 1,
"nVarID" : 24,
"nVarType" : 4,
"strVarName" : "灯3"
}
]
}

2、KvGetTagValue（char* strSetTagName）：

• 该函数的功能是根据变量名称获取变量值，函数返回值为json串，用户根据返回的json串自行解析成结构体，
  结构体成员包含变量名、变量ID、变量类型、变量值。

- 例: get请求 http://localhost:8089/GetTagValue?strTagName=灯1

返回值: {
"VarValue" : 0,
"nVarID" : 21,
"nVarType" : 4,
"strVarName" : "灯1"
}

3、KvSetTagValue(char* strGetTagName, char* strTagValue)：

• 该函数的功能是输入变量名和变量值，修改变量，返回值为JSON。用户密码需要MD5加密(32位小写)

例: get请求 http://localhost:8089/SetTagValue?UserName=abc&PassWord=e10adc3949ba59abbe56e057f20f883e&strTagName=灯1&strSetTagValue=0
值: {
"VarValue" : 0,
"nVarID" : 21,
"nVarType" : 4,
"strVarName" : "灯1"
}

4、KvGetTagBitValue(char* strGetTagName, int nTagBitNum)：

• 该函数的功能是输入变量名和变量位数，返回对应位的Bit值。

例: get请求 http://localhost:8089/GetTagBitValue?strTagName=灯1&strTagBitNum=1
值: -1