Mapping接口文档

2. Action列表

2.1 终端配置指令

2.1.1 创建终端配置

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 否 string 唯一编号
name 是 string 终端配置名称
description 否 string 终端配置描述信息
hardware 否 string 终端硬件信息
mcu_file 否 string mcu文件
mcu_version 否 string mcu版本
remosu_file 否 string remosu文件
remosu_version 否 string remosu版本
lua_file 否 string lua文件
lua_version 否 string lua版本
terminal_script 否 string 终端脚本
config_script 否 string 配置脚本
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更改人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

result:

参数名称 数据类型 描述
uid string 返回终端配置唯一编号

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "create_terminal_config",
    "actionid": "1233445",
    "name": "config1",
    "description": "config number 1",
    "hardware": "arm",
    "mcu_file": "/var/image/default",
    "mcu_version": "v1.0.0",
    "remosu_file": "var/image/default",
    "remosu_version": "v1.0.0",
    "lua_file": "var/image/default",
    "lua_version": "v1.0.0",
    "terminal_script": "{\"alt\": 1}",
    "config_script": "{\"alt\": 1}",
    "reference": "参考号123",
    "created": "2020/9/28 14:44:1",
    "created_by": 1,
    "last_modified": "2020/9/28 14:44:1",
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "create_terminal_config",
    "actionid": "1233445",
    "code": 200,
    "msg": "成功",
    "result": {
        "uid": "TCF1324495600002",
        "name": "config1"
    }
}

2.1.2 更新终端配置

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 终端配置唯一编号
name 是 string 终端配置名称
description 否 string 终端配置描述信息
hardware 否 string 终端硬件信息
mcu_file 否 string mcu文件
mcu_version 否 string mcu版本
remosu_file 否 string remosu文件
remosu_version 否 string remosu版本
lua_file 否 string lua文件
lua_version 否 string lua版本
terminal_script 否 string 终端脚本
config_script 否 string 配置脚本
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更改人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "update_terminal_config",
    "actionid": "1233445",
    "uid": "TCF1324495600002",
    "name": "config2",
    "description": "config number 2",
    "hardware": "arm",
    "mcu_file": "/var/image/default",
    "mcu_version": "v1.0.0",
    "remosu_file": "var/image/default",
    "remosu_version": "v1.0.0",
    "lua_file": "var/image/default",
    "lua_version": "v1.0.0",
    "terminal_script": "{\"alt\": 1}",
    "config_script": "{\"alt\": 1}",
    "reference": "参考号123",
    "created": "2020/9/28 14:44:1",
    "created_by": 1,
    "last_modified": "2020/9/28 14:44:1",
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "update_terminal_config",
    "actionid": "1233445",
    "code": 200,
    "msg": "成功"
}

2.1.3 删除终端配置

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 终端配置唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "delete_terminal_config",
    "actionid": "1234",
    "uid": "TCF1324495600002"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "delete_terminal_config",
    "actionid": "1234",
    "code": 200,
    "msg": "成功"
}

2.1.4 终端配置详情

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 终端配置唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

object:

参数名称 数据类型 描述
id int 表自增编号
organization_id int 组织ID
uid string 终端配置唯一编号
name string 终端配置名称
description string 终端配置描述信息
hardware string 终端硬件信息
mcu_file string mcu文件
mcu_version string mcu版本
remosu_file string remosu文件
remosu_version string remosu版本
lua_file string lua文件
lua_version string lua版本
terminal_script object 终端脚本
config_script object 配置脚本
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更改人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_terminal_config_item",
    "actionid": "12345",
    "uid": "TCF1245422100001"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_terminal_config_item",
    "actionid": "12345",
    "code": 200,
    "msg": "成功",
    "result": {
        "id": 1008,
        "uid": "TCF1245422100001",
        "name": "config1",
        "description": "config number 1",
        "hardware": "arm",
        "mcu_file": "/var/image/default",
        "mcu_version": "v1.0.0",
        "remosu_file": "var/image/default",
        "remosu_version": "v1.0.0",
        "lua_file": "var/image/default",
        "lua_version": "v1.0.0",
        "terminal_script": {
            "alt": 1
        },
        "config_script": {
            "alt": 1
        },
        "reference": "参考号123",
        "created": "2021-02-24 16:07:54",
        "created_by": 1,
        "last_modified": "2021-02-24 16:07:54",
        "last_modified_by": 1,
        "is_available": 1
    }
}

2.1.5 终端配置列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result []object 返回结果

object:

参数名称 数据类型 描述
id int 表自增编号
uid string 终端配置唯一编号
organization_id int 组织ID
name string 终端配置名称
description string 终端配置描述信息
hardware string 终端硬件信息
mcu_file string mcu文件
mcu_version string mcu版本
remosu_file string remosu文件
remosu_version string remosu版本
lua_file string lua文件
lua_version string lua版本
terminal_script object 终端脚本
config_script object 配置脚本
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更改人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
   "action": "get_terminal_config_list",
    "actionid": "123454"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_terminal_config_list",
    "actionid": "123454",
    "code": 200,
    "msg": "成功",
    "result": [
        {
            "id": 1007,
            "uid": "TCF1233360400001",
            "name": "config1",
            "description": "config number 1",
            "hardware": "arm",
            "mcu_file": "/var/image/default",
            "mcu_version": "v1.0.0",
            "remosu_file": "var/image/default",
            "remosu_version": "v1.0.0",
            "lua_file": "var/image/default",
            "lua_version": "v1.0.0",
            "terminal_script": {
                "alt": 1
            },
            "config_script": {
                "alt": 1
            },
            "reference": "参考号123",
            "created": "2021-02-23 15:22:34",
            "created_by": 1,
            "last_modified": "2021-02-23 15:22:34",
            "last_modified_by": 1,
            "is_available": 1
        },
        {
            "id": 1008,
            "uid": "TCF1245422100001",
            "name": "config1",
            "description": "config number 1",
            "hardware": "arm",
            "mcu_file": "/var/image/default",
            "mcu_version": "v1.0.0",
            "remosu_file": "var/image/default",
            "remosu_version": "v1.0.0",
            "lua_file": "var/image/default",
            "lua_version": "v1.0.0",
            "terminal_script": {
                "alt": 1
            },
            "config_script": {
                "alt": 1
            },
            "reference": "参考号123",
            "created": "2021-02-24 16:07:54",
            "created_by": 1,
            "last_modified": "2021-02-24 16:07:54",
            "last_modified_by": 1,
            "is_available": 1
        }
    ]
}

2.2 终端指令

2.2.1 创建终端

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 终端唯一编号
name 是 string 终端名称
description 否 string 终端描述
type 是 string 终端类型
maker 否 string 终端制造商
config_id 是 string 终端配置编号
mode 是 string 检验模式
username 是 string 用户名
pin 是 string 密码
access 是 string 访问权限
topic 否 string 主题
server 否 string gards服务器
session_expiry 否 int 会话过期时间
keep_alive 否 int 保活时间
encryption 否 int 是否加密
dixie 否 int 是否启用scram-sha-1高级鉴权
rsa_privatekey 否 string rsa私钥
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

result:

参数名称 数据类型 描述
uid string 返回终端唯一编号

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "create_terminal",
    "actionid": "12345",
    "uid": "fidiser12",
    "name": "terminal1",
    "description": "terminal1",
    "type": "Aprus-X",
    "maker": "智物联",
    "config_id": "CFG1212994600001",
    "mode": "pwd",
    "username": "test",
    "pin": "test",
    "access": "all",
    "topic": "all",
    "server": "192.168.0.132",
    "session_expiry": 120,
    "keep_alive": 30,
    "encryption": 0,
    "dixie": 1,
    "rsa_privatekey": "12345678",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "create_terminal",
    "actionid": "12345",
    "code": 200,
    "msg": "成功",
    "result": {
        "uid": "fidiser12",
        "name": "terminal1"
    }
}

2.2.2 更新终端

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 终端唯一编号
name 是 string 终端名称
description 否 string 终端描述
type 是 string 终端类型
maker 否 string 终端制造商
config_id 是 string 终端配置编号
mode 是 string 检验模式
username 是 string 用户名
pin 是 string 密码
access 是 string 访问权限
topic 否 string 主题
server 否 string gards服务器
session_expiry 否 int 会话过期时间
keep_alive 否 int 保活时间
encryption 否 int 是否加密
dixie 否 int 是否启用scram-sha-1高级鉴权
rsa_privatekey 否 string rsa私钥
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "update_terminal",
    "actionid": "12345",
    "id": 1012,
    "uid": "fidiser12",
    "name": "terminal7",
    "description": "terminal7",
    "type": "Aprus-X",
    "maker": "智物联",
    "config_id": "CFG1212994600001",
    "is_route": 1,
    "mode": "auto",
    "username": "test",
    "pin": "test",
    "access": "all",
    "topic": "all",
    "server": "192.168.0.132",
    "session_expiry": 120,
    "keep_alive": 30,
    "encryption": 0,
    "dixie": 1,
    "rsa_privatekey": "12345678",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "update_terminal",
    "actionid": "12345",
    "code": 200,
    "msg": "成功"
}

2.2.3 删除终端

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 终端唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "delete_terminal",
    "actionid": "12345",
    "uid": "fidiser12"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "delete_terminal",
    "actionid": "12345",
    "code": 200,
    "msg": "成功"
}

2.2.4 终端详情

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 终端唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

object:

参数名称 数据类型 描述
id int 表自增编号
organization_id int 组织ID
uid string 终端唯一编号
name string 终端名称
description string 终端描述
type string 终端类型
maker string 终端制造商
config_id string 终端配置编号
mode string 检验模式
username string 用户名
pin string 密码
access string 访问权限
topic string 主题
server string gards服务器
session_expiry int 会话过期时间
keep_alive int 保活时间
encryption int 是否加密
dixie int 是否启用scram-sha-1高级鉴权
rsa_privatekey string rsa私钥
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_terminal_item",
    "actionid": "13454",
    "uid": "fidiser1"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_terminal_item",
    "actionid": "13454",
    "code": 200,
    "msg": "成功",
    "result": {
        "id": 1026,
        "uid": "fidiser1",
        "name": "terminal1",
        "description": "terminal1",
        "type": "Aprus-X",
        "maker": "智物联",
        "config_id": "TCF1233360400001",
        "mode": "pwd",
        "username": "test",
        "pin": "test",
        "access": "all",
        "topic": "all",
        "server": "192.168.0.132",
        "session_expiry": 120,
        "keep_alive": 30,
        "encryption": 1,
        "dixie": 1,
        "rsa_privatekey": "12345678",
        "reference": "参考号123",
        "created": "2021-02-24 16:07:50",
        "created_by": 1,
        "last_modified": "2021-02-24 16:07:50",
        "last_modified_by": 1,
        "is_available": 1
    }
}

2.2.5 终端列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uids 否 []string 终端唯一编号列表，若存在，返回指定终端列表

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result []object 返回结果

object:

参数名称 数据类型 描述
id int 表自增编号
organization_id int 组织ID
uid string 终端唯一编号
name string 终端名称
description string 终端描述
type string 终端类型
maker string 终端制造商
config_id string 终端配置编号
mode string 检验模式
username string 用户名
pin string 密码
access string 访问权限
topic string 主题
server string gards服务器
session_expiry int 会话过期时间
keep_alive int 保活时间
encryption int 是否加密
dixie int 是否启用scram-sha-1高级鉴权
rsa_privatekey string rsa私钥
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_terminal_list",
    "actionid": "123",
    "uids": ["test", "test1"]
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_terminal_list",
    "actionid": "123",
    "code": 200,
    "msg": "成功",
    "result": [
        {
            "id": 1022,
            "uid": "test",
            "name": "terminal1",
            "description": "terminal1",
            "type": "Aprus-X",
            "maker": "智物联",
            "config_id": "TCF1233360400001",
            "mode": "pwd",
            "username": "test",
            "pin": "test",
            "access": "all",
            "topic": "all",
            "server": "192.168.0.132",
            "session_expiry": 120,
            "keep_alive": 30,
            "encryption": 1,
            "dixie": 1,
            "rsa_privatekey": "12345678",
            "terminal_object_map": null,
            "reference": "参考号123",
            "created": "2021-02-23 17:55:54",
            "created_by": 1,
            "last_modified": "2021-02-23 17:55:54",
            "last_modified_by": 1,
            "is_available": 1
        },
        {
            "id": 1020,
            "uid": "test1",
            "name": "terminal1",
            "description": "terminal1",
            "type": "Aprus-X",
            "maker": "智物联",
            "config_id": "TCF1233360400001",
            "mode": "pwd",
            "username": "test",
            "pin": "test",
            "access": "all",
            "topic": "all",
            "server": "192.168.0.132",
            "session_expiry": 120,
            "keep_alive": 30,
            "encryption": 1,
            "dixie": 1,
            "rsa_privatekey": "12345678",
            "terminal_object_map": null,
            "reference": "参考号123",
            "created": "2021-02-23 17:52:20",
            "created_by": 1,
            "last_modified": "2021-02-23 17:52:20",
            "last_modified_by": 1,
            "is_available": 1
        }
    ]
}

2.3 映射表指令

2.3.1 创建映射表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 否 string 唯一编号
name 是 string 映射表名称
description 否 string 映射表描述
script 是 string 映射表脚本
addition 否 string 附加信息
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

result:

参数名称 数据类型 描述
uid string 返回映射表唯一编号

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "create_mapping",
    "actionid": "123454",
    "name": "mapping1",
    "description": "mapping number 1",
    "script": "[[\"v1\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"\", \"\"], [\"v2\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1+10\", \"\"], [\"v3\", \"\", \"STA变量-固定适配器\", \"STA\", \"AX20210229000249.L1_3_7_2\", \"v2+10\", \"\"], [\"v4\", \"\", \"离线推送\", \"STA\", \"$CollectID-1.Tem\", \"Tem+20\", \"\"], [\"v5\", \"\", \"离线推送\", \"STA\", \"COL12236500002.Tem\", \"Tem+5\", \"\"], [\"v6\", \"\", \"函数计算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"min(v1, v2)\", \"\"], [\"v7\", \"\", \"比较运算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1>v2?v1:v2\", \"\"], [\"1001\", \"start event\", \"开始事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==0\"], [\"1002\", \"stop event\", \"停止事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==1\"]]",
    "addition": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "create_mapping",
    "actionid": "123454",
    "code": 200,
    "msg": "成功",
    "result": {
        "uid": "MAP1324472700003",
        "name": "mapping1"
    }
}

2.3.2 更新映射表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 映射表唯一编号
name 是 string 映射表名称
description 否 string 映射表描述
script 是 string 映射表脚本
addition 否 string 附加信息
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "update_mapping",
    "actionid": "123454",
    "uid": "MAP1324472700003",
    "name": "mapping1",
    "description": "mapping number 1",
    "script": "[[\"v1\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"\", \"\"], [\"v2\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1+10\", \"\"], [\"v3\", \"\", \"STA变量-固定适配器\", \"STA\", \"AX20210229000249.L1_3_7_2\", \"v2+10\", \"\"], [\"v4\", \"\", \"离线推送\", \"STA\", \"$CollectID-1.Tem\", \"Tem+20\", \"\"], [\"v5\", \"\", \"离线推送\", \"STA\", \"COL12236500002.Tem\", \"Tem+5\", \"\"], [\"v6\", \"\", \"函数计算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"min(v1, v2)\", \"\"], [\"v7\", \"\", \"比较运算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1>v2?v1:v2\", \"\"], [\"1001\", \"start event\", \"开始事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==0\"], [\"1002\", \"stop event\", \"停止事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==1\"]]",
    "addition": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "update_mapping",
    "actionid": "123454",
    "code": 200,
    "msg": "成功"
}

2.3.3 删除映射表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 映射表唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "delete_mapping",
    "actionid": "123456",
    "uid": "MAP1324472700003"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "delete_mapping",
    "actionid": "123456",
    "code": 200,
    "msg": "成功"
}

2.3.4 映射表详情

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 映射表唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

object:

参数名称 数据类型 描述
action string 指令
actionid string 指令编号
organization_id int 组织ID
uid string 映射表唯一编号
name string 映射表名称
description string 映射表描述
script []array 映射表脚本
addition []object 附加信息
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新人
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_mapping_item",
    "actionid": "12345",
    "uid": "MAP1212994600001"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_mapping_item",
    "actionid": "12345",
    "code": 200,
    "msg": "成功",
    "result": {
        "id": 1020,
        "uid": "MAP1212994600001",
        "name": "mapping",
        "description": "mapping number 1",
        "script": [
            [
                "v1",
                "",
                "STA变量-相对适配器",
                "STA",
                "$AprusID-1.L1_3_7_2",
                "",
                ""
            ],   
            [
                "v6",
                "",
                "函数计算",
                "STA",
                "$AprusID-1.L1_3_7_2",
                "min(v1, v2)",
                ""
            ],
            [
                "v7",
                "",
                "比较运算",
                "STA",
                "$AprusID-1.L1_3_7_2",
                "v1>v2?v1:v2",
                ""
            ],
            [
                "v11",
                "",
                "STA变量-相对适配器",
                "STA",
                "$AprusID-1.L1_3_7_2",
                "v1+10",
                ""
            ],      
        ],
        "addition": [
            {
                "data": [
                    [
                        "a",
                        ""
                    ],
                    [
                        "b",
                        ""
                    ]
                ],
                "title": "扩展信息1"
            }
        ],
        "reference": "参考号123",
        "created": "2021-02-21 14:13:30",
        "created_by": 1,
        "last_modified": "2021-03-25 14:51:53",
        "last_modified_by": 1,
        "is_available": 1
    }
}

2.3.5 映射表列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result []object 返回结果

object:

参数名称 数据类型 描述
action string 指令
actionid string 指令编号
organization_id int 组织ID
uid string 映射表唯一编号
name string 映射表名称
description string 映射表描述
script []array 映射表脚本
addition []object 附加信息
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新人
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_mapping_list",
    "actionid": "12345"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_mapping_list",
    "actionid": "12345",
    "code": 200,
    "msg": "成功",
    "result": [
        {
            "id": 1020,
            "uid": "MAP1212994600001",
            "name": "mapping",
            "description": "mapping number 1",
            "script": [
                [
                    "v1",
                    "",
                    "STA变量-相对适配器",
                    "STA",
                    "$AprusID-1.L1_3_7_2",
                    "",
                    ""
                ],
                [
                    "v2",
                    "",
                    "STA变量-相对适配器",
                    "STA",
                    "$AprusID-1.L1_3_7_2",
                    "v1+10",
                    ""
                ],
                [
                    "v3",
                    "",
                    "STA变量-相对适配器",
                    "STA",
                    "$AprusID-1.L1_3_7_2",
                    "",
                    ""
                ],
                [
                    "v4",
                    "",
                    "STA变量-相对适配器",
                    "STA",
                    "$AprusID-1.L1_3_7_2",
                    "v1+10",
                    ""
                ]
            ],
            "addition": [
                {
                    "data": [
                        [
                            "a",
                            ""
                        ],
                        [
                            "b",
                            ""
                        ]
                    ],
                    "title": "扩展信息1"
                }
            ],
            "reference": "参考号123",
            "created": "2021-02-21 14:13:30",
            "created_by": 1,
            "last_modified": "2021-03-25 14:51:53",
            "last_modified_by": 1,
            "is_available": 1
        }
    ]
}

2.4 对象指令

2.4.1 创建对象

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 否 string 唯一编号
name 是 string 对象名称
description 否 string 对象描述
image 否 string 图片路径
province 否 string 省份
city 否 string 城市/地区
mapping_id 是 string 映射表编号
control_id 否 string 控制码编号
terminal_list 是 []string 终端列表
object_list 否 []string 对象列表
collect_list 否 []string 离线列表
tag 否 []string 标签列表
model 否 string 型号
serial_no 否 string 序列号
gis 否 string 位置信息
secret 否 string 关注密码
control 否 string 控制代码
addition 否 string 附加信息
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

result:

参数名称 数据类型 描述
uid string 返回对象唯一编号

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "create_object",
    "actionid": "",
    "name": "object1",
    "description": "temperature object",
    "image": "/var/image/default.png",
    "province": "广东省",
    "city": "深圳市",
    "mapping_id": "MAP1212994600001",
    "control_id": "CTL1212994600001",
    "terminal_list": ["test","test1"],
    "object_list": [],
    "collect_list": ["test","test1"],
    "tag": ["test","test1"],
    "model": "model1",
    "serial_no": "1234566778999999",
    "gis": "深圳南山区",
    "secret": "1234567887654321",
    "control": "1234567887654321",
    "addition": "{\"id\":1}",
    "reference": "123456",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "create_object",
    "actionid": "",
    "code": 200,
    "msg": "成功",
    "result": {
        "uid": "OBJ1321207800001",
        "name": "object1"
    }
}

2.4.2 更新对象

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 对象唯一编号
name 是 string 对象名称
description 否 string 对象描述
image 否 string 图片路径
province 否 string 省份
city 否 string 城市/地区
mapping_id 是 string 映射表编号
control_id 否 string 控制码编号
terminal_list 是 []string 终端列表
object_list 否 []string 对象列表
collect_list 否 []string 离线列表
tag 否 []string 标签列表
model 否 string 型号
serial_no 否 string 序列号
gis 否 string 位置信息
secret 否 string 关注密码
control 否 string 控制代码
addition 否 string 附加信息
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "update_object",
    "actionid": "",
    "id": 1001,
    "uid": "OBJ1321207800001",
   "name": "object1",
    "description": "temperature object",
    "image": "/var/image/default.png",
    "province": "广东省",
    "city": "深圳市",
    "mapping_id": "MAP1212994600001",
    "control_id": "CTL1212994600001",
    "terminal_list": ["test","test1"],
    "object_list": [],
    "collect_list": ["test","test1"],
    "tag": ["test","test1"],
    "model": "model1",
    "serial_no": "1234566778999999",
    "gis": "深圳南山区",
    "secret": "1234567887654321",
    "control": "1234567887654321",
    "addition": "{\"id\":1}",
    "reference": "123456",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "update_object",
    "actionid": "",
    "code": 200,
    "msg": "成功"
}

2.4.3 删除对象

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 对象唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "delete_object",
    "actionid": "123",
    "uid": "OBJ1321207800001"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "delete_object",
    "actionid": "123",
    "code": 200,
    "msg": "成功"
}

2.4.4 对象详情

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 对象唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

object：

参数名称 数据类型 描述
id int 表自增编号
organization_id int 组织ID
uid string 对象唯一编号
name string 对象名称
description string 对象描述
image string 图片路径
province string 省份
city string 城市/地区
mapping_id string 映射表编号
control_id string 控制码编号
terminal_list []string 终端列表
object_list []string 对象列表
collect_list []string 离线列表
tag []string 标签列表
model string 型号
serial_no string 序列号
gis string 位置信息
secret string 关注密码
control string 控制代码
addition object 附加信息
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效
is_boot int 是否启动
object_fv_map object 对象的fv映射关系

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_object_item",
    "actionid": "123",
    "uid": "OBJ1310573400002"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_object_item",
    "actionid": "123",
    "code": 200,
    "msg": "成功",
    "result": {
        "id": 1047,
        "uid": "OBJ1310573400002",
        "name": "object1",
        "description": "temperature object",
        "image": "/var/image/default.png",
        "province": "广东省",
        "city": "深圳市",
        "mapping_id": "MAP1212994600001",
        "control_id": "CTL1212994600001",
        "terminal_list": [
            "test",
            "test1"
        ],
        "object_list": [],
        "collect_list": [
            "test",
            "test1"
        ],
        "tag": [
            "test",
            "test1"
        ],
        "model": "model1",
        "serial_no": "1234566778999999",
        "gis": "深圳南山区",
        "secret": "1234567887654321",
        "control": "1234567887654321",
        "addition": {
            "id": 1
        },
        "reference": "123456",
        "created": "2021-03-11 17:10:06",
        "created_by": 1,
        "last_modified": "2021-03-11 17:10:06",
        "last_modified_by": 1,
        "is_available": 1,
        "is_online": 0,
        "is_boot": 0,
        "object_fv_map": {
            "OBJ1310573400002": [
                {
                    "object_id": "OBJ1310573400002",
                    "fv": "v1",
                    "label_en": "",
                    "label_local": "STA变量-相对适配器",
                    "category": "STA",
                    "datasource": "test.L1_3_7_2",
                    "logic_expr1": "",
                    "logic_expr2": "return true"
                }
            ]
        }
    }
}

2.4.5 对象列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uids 否 []string 对象编号列表，若存在，则返回指定对象编号列表的对象

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result []object 返回结果

object：

参数名称 数据类型 描述
id int 表自增编号
organization_id int 组织ID
uid string 对象唯一编号
name string 对象名称
description string 对象描述
image string 图片路径
province string 省份
city string 城市/地区
mapping_id string 映射表编号
control_id string 控制码编号
terminal_list []string 终端列表
object_list []string 对象列表
collect_list []string 离线列表
tag []string 标签列表
model string 型号
serial_no string 序列号
gis string 位置信息
secret string 关注密码
control string 控制代码
addition object 附加信息
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效
is_boot int 是否启动
object_fv_map object 对象的fv映射关系

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_object_list",
    "actionid": "1234",
    "uids": ["OBJ1343732600001", "OBJ1312304800002"]
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_object_list",
    "actionid": "1234",
    "code": 200,
    "msg": "成功",
    "result": [
        {
            "id": 1028,
            "uid": "OBJ1343732600001",
            "name": "object1",
            "description": "temperature object",
            "image": "/var/image/default.png",
            "province": "广东省",
            "city": "深圳市",
            "mapping_id": "MAP1352825300001",
            "control_id": "CTL1212994600001",
            "terminal_list": [
                "test",
                "test1"
            ],
            "object_list": [
                "OBJ1343732600001"
            ],
            "collect_list": [
                "test",
                "test1"
            ],
            "tag": [
                "test",
                "test1"
            ],
            "model": "model1",
            "serial_no": "1234566778999999",
            "gis": "深圳南山区",
            "secret": "1234567887654321",
            "control": "1234567887654321",
            "addition": {
                "id": 1
            },
            "reference": "123456",
            "created": "2021-03-04 11:50:37",
            "created_by": 1,
            "last_modified": "2021-03-04 11:50:37",
            "last_modified_by": 1,
            "is_available": 1,
            "is_online": 0,
            "is_boot": 0,
            "object_fv_map": {
                "OBJ1343732600001": [
                    {
                        "object_id": "OBJ1343732600001",
                        "fv": "v1",
                        "label_en": "",
                        "label_local": "STA变量-相对适配器",
                        "category": "STA",
                        "datasource": "test.L1_3_7_2",
                        "logic_expr1": "",
                        "logic_expr2": "return true"
                    }
                ]
            }
        }
    ]
}

2.5 控制码指令

2.5.1 创建控制码

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 否 string 唯一编号
name 是 string 控制码编号
description 否 string 控制码描述
script 是 string 控制码脚本
template 否 string 控制码模板
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

result:

参数名称 数据类型 描述
uid string 返回控制码唯一编号

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "create_control",
    "actionid": "123455",
    "name": "control1",
    "description": "control number 1",
    "script": "[[\"S001\",\"\",\"模拟变量1\",\"OBJ\",\"$AprusID-1.L1_3_8\",\"\"],[\"S002\",\"\",\"模拟变量2\",\"OBJ\",\"$AprusID-1.L1_3_9\",\"\"],[\"AXUpgrade\",\"Aprus Upgrade\",\"适配器升级\",\"APR\",\"$AprusID-1\",\"LUA\"]]",
    "template": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "create_control",
    "actionid": "123455",
    "code": 200,
    "msg": "成功",
    "result": {
        "uid": "CTL1322264700004",
        "name": "control1"
    }
}

2.5.2 更新控制码

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
organization_id 否 string 组织ID
uid 是 string 控制码唯一编号
name 是 string 控制码编号
description 否 string 控制码描述
script 是 string 控制码脚本
template 否 string 控制码模板
reference 否 string 参考号
created_by 是 int 创建人
last_modified_by 是 int 更新人
is_available 是 int 是否生效

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "update_control",
    "actionid": "123455",
    "uid": "CTL1322264700004",
    "name": "control2",
    "description": "control number 2",
    "script": "[[\"S001\",\"\",\"模拟变量1\",\"OBJ\",\"$AprusID-1.L1_3_8\",\"\"],[\"S002\",\"\",\"模拟变量2\",\"OBJ\",\"$AprusID-1.L1_3_9\",\"\"],[\"AXUpgrade\",\"Aprus Upgrade\",\"适配器升级\",\"APR\",\"$AprusID-1\",\"LUA\"]]",
    "template": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "update_control",
    "actionid": "123455",
    "code": 200,
    "msg": "成功"
}

2.5.3 删除控制码

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 控制码唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "delete_control",
    "actionid": "12345",
    "uid": "CTL1322264700004"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "delete_control",
    "actionid": "12345",
    "code": 200,
    "msg": "成功"
}

2.5.4 控制码详情

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
uid 是 string 控制码唯一编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

object：

参数名称 数据类型 描述
action string 指令
actionid string 指令编号
organization_id int 组织ID
uid string 控制码唯一编号
name string 控制码编号
description string 控制码描述
script []array 控制码脚本
template object 控制码模板
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_control_item",
    "actionid": "123456",
    "uid": "CTL1322264700004"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_control_item",
    "actionid": "123456",
    "code": 200,
    "msg": "成功",
    "result": {
        "id": 1006,
        "uid": "CTL1235832900001",
        "name": "control1",
        "description": "control number 1",
        "script": [
            [
                "S001",
                "",
                "模拟变量1",
                "OBJ",
                "$AprusID-1.L1_3_8",
                ""
            ],
            [
                "S002",
                "",
                "模拟变量2",
                "OBJ",
                "$AprusID-1.L1_3_9",
                ""
            ],
            [
                "AXUpgrade",
                "Aprus Upgrade",
                "适配器升级",
                "APR",
                "$AprusID-1",
                "LUA"
            ]
        ],
        "template": {
            "id": 1
        },
        "reference": "参考号123",
        "created": "2021-02-23 15:07:58",
        "created_by": 1,
        "last_modified": "2021-02-23 15:07:58",
        "last_modified_by": 1,
        "is_available": 1
    }
}

2.5.5 控制码列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result []object 返回结果

object：

参数名称 数据类型 描述
action string 指令
actionid string 指令编号
organization_id int 组织ID
uid string 控制码唯一编号
name string 控制码编号
description string 控制码描述
script []array 控制码脚本
template object 控制码模板
reference string 参考号
created string 创建时间
created_by int 创建人
last_modified string 更新时间
last_modified_by int 更新人
is_available int 是否生效

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_control_list",
    "actionid": "12345"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_control_list",
    "actionid": "12345",
    "code": 200,
    "msg": "成功",
    "result": [
        {
            "id": 1006,
            "uid": "CTL1235832900001",
            "name": "control1",
            "description": "control number 1",
            "script": [
                [
                    "S001",
                    "",
                    "模拟变量1",
                    "OBJ",
                    "$AprusID-1.L1_3_8",
                    ""
                ],
                [
                    "S002",
                    "",
                    "模拟变量2",
                    "OBJ",
                    "$AprusID-1.L1_3_9",
                    ""
                ],
                [
                    "AXUpgrade",
                    "Aprus Upgrade",
                    "适配器升级",
                    "APR",
                    "$AprusID-1",
                    "LUA"
                ]
            ],
            "template": {
                "id": 1
            },
            "reference": "参考号123",
            "created": "2021-02-23 15:07:58",
            "created_by": 1,
            "last_modified": "2021-02-23 15:07:58",
            "last_modified_by": 1,
            "is_available": 1
        }
    ]
}

2.6 其他指令

2.6.1 对象编号列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
mapping_id 是 string 映射表编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_objectids_by_mappingid",
    "mapping_id": "MAP1212994600001"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_objectids_by_mappingid",
    "code": 200,
    "msg": "成功",
    "result": [
        "OBJ1243475500001",
        "OBJ1312304800002",
        "OBJ1315157900003",
        "OBJ1315925700001",
        "OBJ1315495000001",
        "OBJ1310573400002"
    ]
}

2.6.2 离线编号列表

请求参数：

参数名称 是否必选 数据类型 描述
action 是 string 指令
actionid 否 string 指令编号
collect_id 是 string 离线编号

响应参数：

参数名称 数据类型 描述
resp string 返回指令
actionid string 返回指令编号
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例：

curl -H "Content-Type: application/json" -X POST -d '{
    "action": "get_objectids_by_collectid",
    "collect_id": "COL1212994600001"
}' http://192.168.88.202:8011/mapping/api

响应示例：

{
    "resp": "get_objectids_by_collectid",
    "code": 200,
    "msg": "成功",
    "result": [
        "OBJ1243475500001",
        "OBJ1312304800002",
        "OBJ1315157900003",
        "OBJ1315925700001",
        "OBJ1315495000001",
        "OBJ1310573400002"
    ]
}

3. Event列表

3.1 终端配置事件

3.1.1 创建终端配置事件

{
    "event": "create_terminal_config",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "TCF1323431200006",
    "name": "config1",
    "description": "config number 1",
    "hardware": "arm",
    "mcu_file": "/var/image/default",
    "mcu_version": "v1.0.0",
    "remosu_file": "var/image/default",
    "remosu_version": "v1.0.0",
    "lua_file": "var/image/default",
    "lua_version": "v1.0.0",
    "terminal_script": "{\"alt\": 1}",
    "config_script": "{\"alt\": 1}",
    "reference": "参考号123",
    "created": "2020/9/28 14:44:1",
    "created_by": 1,
    "last_modified": "2020/9/28 14:44:1",
    "last_modified_by": 1,
    "is_available": 1
}

3.1.2 更新终端配置事件

{
    "event": "update_terminal_config",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "TCF1323431200006",
    "name": "config2",
    "description": "config number 2",
    "hardware": "arm",
    "mcu_file": "/var/image/default",
    "mcu_version": "v1.0.0",
    "remosu_file": "var/image/default",
    "remosu_version": "v1.0.0",
    "lua_file": "var/image/default",
    "lua_version": "v1.0.0",
    "terminal_script": "{\"alt\": 1}",
    "config_script": "{\"alt\": 1}",
    "reference": "参考号123",
    "created": "2020/9/28 14:44:1",
    "created_by": 1,
    "last_modified": "2020/9/28 14:44:1",
    "last_modified_by": 1,
    "is_available": 1
}

3.1.3 删除终端配置事件

{
    "event": "delete_terminal_config",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "uid": "TCF1323431200006"
}

3.2 终端事件

3.2.1 创建终端事件

{
    "event": "create_terminal",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "fidiser12",
    "name": "terminal1",
    "description": "terminal1",
    "type": "Aprus-X",
    "maker": "智物联",
    "config_id": "TCF1212994600001",
    "mode": "pwd",
    "username": "test",
    "pin": "test",
    "access": "all",
    "topic": "all",
    "server": "192.168.0.132",
    "session_expiry": 120,
    "keep_alive": 30,
    "encryption": 0,
    "dixie": 1,
    "rsa_privatekey": "12345678",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.2.2 更新终端事件

{
    "event": "update_terminal",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "fidiser12",
    "name": "terminal7",
    "description": "terminal7",
    "type": "Aprus-X",
    "maker": "智物联",
    "config_id": "TCF1212994600001",
    "is_route": 1,
    "mode": "auto",
    "username": "test",
    "pin": "test",
    "access": "all",
    "topic": "all",
    "server": "192.168.0.132",
    "session_expiry": 120,
    "keep_alive": 30,
    "encryption": 0,
    "dixie": 1,
    "rsa_privatekey": "12345678",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.2.3 删除终端事件

{
    "event": "delete_terminal",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "uid": "fidiser12"
}

3.2.4 终端上线事件

{
    "block": "mapping",
    "datetime": "2021-05-10 11:48:38.416995644",
    "event": "terminal_online",
    "uid": "fidiser12",
    "online": 1,
    "uniqueid": "PUB1503841600007"
}

3.2.5 终端离线事件

{
    "block": "mapping",
    "datetime": "2021-05-10 14:31:26.152819794",
    "event": "terminal_offline",
    "uid": "fidiser12",
    "online": 0,
    "uniqueid": "PUB1502615200001"
}

3.3 映射表事件

3.2.1 创建映射表事件

{
    "event": "create_mapping",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "MAP1323431200006",
    "name": "mapping1",
    "description": "mapping number 1",
    "script": "[[\"v1\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"\", \"\"], [\"v2\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1+10\", \"\"], [\"v3\", \"\", \"STA变量-固定适配器\", \"STA\", \"AX20210229000249.L1_3_7_2\", \"v2+10\", \"\"], [\"v4\", \"\", \"离线推送\", \"STA\", \"$CollectID-1.Tem\", \"Tem+20\", \"\"], [\"v5\", \"\", \"离线推送\", \"STA\", \"COL12236500002.Tem\", \"Tem+5\", \"\"], [\"v6\", \"\", \"函数计算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"min(v1, v2)\", \"\"], [\"v7\", \"\", \"比较运算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1>v2?v1:v2\", \"\"], [\"1001\", \"start event\", \"开始事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==0\"], [\"1002\", \"stop event\", \"停止事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==1\"]]",
    "addition": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.2.2 更新映射表事件

{
    "event": "update_mapping",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "MAP1323431200006",
    "name": "mapping1",
    "description": "mapping number 1",
    "script": "[[\"v1\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"\", \"\"], [\"v2\", \"\", \"STA变量-相对适配器\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1+10\", \"\"], [\"v3\", \"\", \"STA变量-固定适配器\", \"STA\", \"AX20210229000249.L1_3_7_2\", \"v2+10\", \"\"], [\"v4\", \"\", \"离线推送\", \"STA\", \"$CollectID-1.Tem\", \"Tem+20\", \"\"], [\"v5\", \"\", \"离线推送\", \"STA\", \"COL12236500002.Tem\", \"Tem+5\", \"\"], [\"v6\", \"\", \"函数计算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"min(v1, v2)\", \"\"], [\"v7\", \"\", \"比较运算\", \"STA\", \"$AprusID-1.L1_3_7_2\", \"v1>v2?v1:v2\", \"\"], [\"1001\", \"start event\", \"开始事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==0\"], [\"1002\", \"stop event\", \"停止事件\", \"EVNT\", \"$AprusID-1.L1_3_7_2\", \"\", \"v1==1\"]]",
    "addition": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.3.3 删除映射表事件

{
    "event": "delete_mapping",
    "block": "mapping",
    "uniqueid": "PUB1323431200006",
    "datetime": "2021-03-12 16:15:34",
    "uid": "MAP1323431200006",
}

3.4 对象事件

3.4.1 创建对象事件

{
    "event": "create_object",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "OBJ1321207800001",
    "name": "object1",
    "description": "temperature object",
    "image": "/var/image/default.png",
    "province": "广东省",
    "city": "深圳市",
    "mapping_id": "MAP1212994600001",
    "control_id": "CTL1212994600001",
    "terminal_list": ["test","test1"],
    "object_list": [],
    "collect_list": ["test","test1"],
    "tag": ["test","test1"],
    "model": "model1",
    "serial_no": "1234566778999999",
    "gis": "深圳南山区",
    "secret": "1234567887654321",
    "control": "1234567887654321",
    "addition": "{\"id\":1}",
    "reference": "123456",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.4.2 更新对象事件

{
    "event": "update_object",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "OBJ1321207800001",
    "name": "object1",
    "description": "temperature object",
    "image": "/var/image/default.png",
    "province": "广东省",
    "city": "深圳市",
    "mapping_id": "MAP1212994600001",
    "control_id": "CTL1212994600001",
    "terminal_list": ["test","test1"],
    "object_list": [],
    "collect_list": ["test","test1"],
    "tag": ["test","test1"],
    "model": "model1",
    "serial_no": "1234566778999999",
    "gis": "深圳南山区",
    "secret": "1234567887654321",
    "control": "1234567887654321",
    "addition": "{\"id\":1}",
    "reference": "123456",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.4.3 删除对象事件

{
    "event": "delete_object",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "uid": "OBJ1321207800001"
}

3.5 控制表事件

3.5.1 创建控制表事件

{
    "event": "create_control",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "CTL1321207800001",
    "name": "control1",
    "description": "control number 1",
    "script": "[[\"S001\",\"\",\"模拟变量1\",\"OBJ\",\"$AprusID-1.L1_3_8\",\"\"],[\"S002\",\"\",\"模拟变量2\",\"OBJ\",\"$AprusID-1.L1_3_9\",\"\"],[\"AXUpgrade\",\"Aprus Upgrade\",\"适配器升级\",\"APR\",\"$AprusID-1\",\"LUA\"]]",
    "template": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.5.2 更新控制表事件

{
    "event": "update_control",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "organization_id": 1,
    "uid": "CTL1321207800001",
    "name": "control2",
    "description": "control number 2",
    "script": "[[\"S001\",\"\",\"模拟变量1\",\"OBJ\",\"$AprusID-1.L1_3_8\",\"\"],[\"S002\",\"\",\"模拟变量2\",\"OBJ\",\"$AprusID-1.L1_3_9\",\"\"],[\"AXUpgrade\",\"Aprus Upgrade\",\"适配器升级\",\"APR\",\"$AprusID-1\",\"LUA\"]]",
    "template": "{\"id\":1}",
    "reference": "参考号123",
    "created_by": 1,
    "last_modified_by": 1,
    "is_available": 1
}

3.5.3 删除控制表事件

{
    "event": "delete_control",
    "block": "mapping",
    "uniqueid": "PUB1321207800001",
    "datetime": "2021-03-12 16:15:34",
    "uid": "CTL1321207800001",
}

4.Pusher 指令下发说明

Pusher 是指令下发服务，提供发送控制指令的接口，控制指令信息由对象的控制码脚本描述，指令下发服务根据指定对象的控制码脚本发送对应的控制指令到 Fido。

4.1 控制码脚本

脚本格式

[Command，Label_En，Label_Cn，Category，Key，Value]

** 格式说明**

[控制指令，英文标签，中文标签，控制类型，控制点位，控制值]

脚本举例

[
    ["Control_01", "Set Temperature", "设置温度", "OBJ", "$AprusID-1.L1_2_123", ""],
    ["Control_02", "Device Boot", "设备开机", "OBJ", "$AprusID-1.L1_2_234", "1"],
    ["Control_03", "Device Shutdown", "设备关机", "OBJ", "$AprusID-1.L1_2_345", "0"],
    ["Upgrade", "Aprus Upgrade", "适配器升级", "APR", "$AprusID-1", ""],
    ["Reboot", "Aprus Reboot", "适配器重启", "APR", "$AprusID-1", ""]
]

字段说明

  1. 控制指令（Command）：
    控制指令分为两种：自定义指令 和 保留指令。其中，保留指令是针对适配器的预定义指令：
    类型 说明 可选控制值
    Upgrade 适配器升级 LUA，REMOSU，MCU，FTPLUA，FTPMCU
    Reboot 适配器重启

  2. 英文标签（Label_En）：
    英文标签 即 英文说明。

  3. 中文标签（Label_Cn）：
    中文标签 即 中文说明。

  4. 控制类型（Category）：
    控制类型 说明
    OBJ 对象控制
    APR 适配器控制
    其中，控制类型为APR时，控制指令是预定义指令 Upgrade、Reboot。

  5. 控制点位（Key）：
    $AprusID-1，表示第一个适配器；
    $AprusID-1.L1_2_123，表示第一个适配器的L1_2_123的点位。

  6. 控制值（Value）：
    控制值为空时，表示用户自定义填写；
    控制值不为空时，则发送脚本中的控制值。

4.2 Pusher action 说明

4.2.1 发送控制码指令

向对象发布对象配置好的控制码指令

  • 参数
参数名称 是否必选 数据类型 数据约束 描述
action 是 String publish_object_command 方法名
actionid 否 String 活动标识
object_id 是 String 对象id
command 是 String 控制码指令
value 否 String 控制值
  • 示例
{
    "action": "publish_object_command",
    "object_id": "OBJ1243475500001",
    "command": "Control_01", // 对应控制码脚本中的第一列
    "value": "1"
}
  • 响应
{
    "resp": "publish_object_command",
    "actionid": "",
    "code": 200,
    "msg": "成功",
    "result": {}
}

4.2.2 批量发送控制码指令

向对象发布多条对象配置好的控制码指令

  • 参数
参数名称 是否必选 数据类型 数据约束 描述
action 是 String publish_object_command_plus 方法名
actionid 否 String 活动标识
publishes 是 List 控制列表
+object_id 是 String 对象id
+command 是 String 控制码指令
+value 否 String 控制值
  • 示例
{
    "action": "publish_object_command_plus",
    "publishes": [
        {
            "object_id": "OBJ1243475500001",
            "command": "Control_01", // 对应控制码脚本中的第一列
            "value": "1"
        }, 
        {
            "object_id": "OBJ1243475500002",
            "command": "Control_01", // 对应控制码脚本中的第一列
            "value": "1"
        }, 
    ]
}
  • 响应
{
    "resp": "publish_object_command_plus",
    "actionid": "",
    "code": 200,
    "msg": "成功",
    "result": {}
}

4.2.3 直接向终端发送控制指令

直接向终端发送控制指令

  • 参数
参数名称 是否必选 数据类型 数据约束 描述
action 是 String publish_terminal_command 方法名
actionid 否 String 活动标识
terminal_id 是 String 终端id
command 是 String 控制码指令
value 否 String 控制值
  • 示例
{
    "action": "publish_terminal_command",
    "terminal_id": "AX1001",
    "command": "AXUpgrade", // 对应控制码脚本中的第一列
    "value": "LUA"
}
  • 响应
{
    "resp": "publish_terminal_command",
    "actionid": "",
    "code": 200,
    "msg": "成功",
    "result": {}
}
文档更新时间: 2024-04-23 18:53   作者：技术支持