1. hapim接口说明

1.1. 文档说明

本文档为hapim组件API接口说明

1.2. 修订记录

日期 文档版本 修订内容 修改人
2020-10-13 v0.1 添加拼图接口 lizefang

1.3. 接口约定

规则 描述
服务器域名(IP) 以部署为准,如: https://xxx.mixiot.top
接口鉴权 令牌机制,详情请阅接口鉴权
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式

1.4. 响应说明

1.4.1. 返回码

code 含义 备注
200 请求成功 Code不为200,则说明请求失败
500 请求错误

1.4.2. 格式

1.单条记录

{
    "code":200,
    "msg":"success",
    "info":"",
    "result":{}
}

2.多条记录

{
    "code":200,
    "msg":"success",
    "info":"",
    "result":{
        "page_index":1,
        "page_size":20,
        "total_pages":0,
        "total_records":0,
        "data":[]
    }
}

1.5. 拼图接口

1.5.1. 查询最新⼀个拼图数据

请求地址:

属性
URL /api/v1/mosaic/getLastItem
Method get
Content-Type application/json

请求参数:

参数名称 是否必选 数据类型 数据约束 示例数据 描述
object_id string --- --- 编号
keys []string --- ["S06", "S07"] FV列表

响应参数:

参数名称 是否必选 数据类型 描述
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例

curl -H "Content-Type: application/json" -X GET "https://xxx.mixiot.top/hapim/api/v1/mosaic/getLastItem?object_id=1&keys=["S06"]

返回示例:

{
    "code": 200,
    "msg": "成功",
    "info": "",
    "result": [
        {
            "time": "2020-10-13 16:26:43",
            "value": {
                "S06": "36"
            }
        }
    ]
}

1.5.2. 查询某⼀个时刻的⼀个拼图数据

请求地址:

属性
URL /api/v1/mosaic/getItemByTime
Method get
Content-Type application/json

请求参数:

参数名称 是否必选 数据类型 数据约束 示例数据 描述
object_id string --- --- 编号
time string --- --- 时间
keys []string --- ["S06", "S07"] FV列表

响应参数:

参数名称 是否必选 数据类型 描述
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例

curl -H "Content-Type: application/json" -X GET "https://xxx.mixiot.top/hapim/api/v1/mosaic/getItemByTime?object_id=1&time=2015-08-18T00:00:00Z&keys=["S06"]

返回示例:

{
    "code": 200,
    "msg": "成功",
    "info": "",
    "result": [
        {
            "time": "2020-10-10 09:48:56",
            "value": {
                "S06": "36"
            }
        }
    ]
}

1.5.3. 查询最新的指定数量的拼图数据

请求地址:

属性
URL /api/v1/mosaic/getLastListByItem
Method get
Content-Type application/json

请求参数:

参数名称 是否必选 数据类型 数据约束 示例数据 描述
object_id string --- --- 编号
items string --- --- 条数
keys []string --- ["S06", "S07"] FV列表

响应参数:

参数名称 是否必选 数据类型 描述
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例

curl -H "Content-Type: application/json" -X GET "https://xxx.mixiot.top/hapim/api/v1/mosaic/getLastListByItem?object_id=1&items=3&keys=["S06"]

返回示例:

{
    "code": 200,
    "msg": "成功",
    "info": "",
    "result": {
        "data": [
            {
                "time": "2020-10-13 16:26:43",
                "value": {
                    "S06": "36"
                }
            },
            {
                "time": "2020-10-13 16:26:33",
                "value": {
                    "S06": "36"
                }
            },
            {
                "time": "2020-10-13 16:26:23",
                "value": {
                    "S06": "36"
                }
            }
        ]
    }
}

1.5.4. 查询某⼀个时间段的拼图数据

请求地址:

属性
URL /api/v1/mosaic/getListByDuration
Method get
Content-Type application/json

请求参数:

参数名称 是否必选 数据类型 数据约束 示例数据 描述
object_id string --- --- 编号
page_index string --- --- 页数
page_size string --- --- 每页条数
start_time string --- --- 开始时间
end_time string --- --- 结束时间
keys []string --- ["S06", "S07"] FV列表

响应参数:

参数名称 是否必选 数据类型 描述
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例

curl -H "Content-Type: application/json" -X GET "https://xxx.mixiot.top/hapim/api/v1/mosaic/getListByDuration?object_id=1&page_index=1&page_size=5&start_time=2020-10-13T09:40:42Z&end_time=2020-10-13T16:41:22Z&keys=["S06", "S07"]

返回示例:

{
    "code": 200,
    "msg": "成功",
    "info": "",
    "result": {
        "data": [
            {
                "time": "2020-10-13 16:26:43",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:33",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:23",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:13",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:03",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            }
        ],
        "page_index": 1,
        "page_size": 5,
        "total_pages": 488,
        "total_records": 2436
    }
}

1.5.5. 通过Keys查询某⼀个时间段的拼图数据

请求地址:

属性
URL /api/v1/mosaic/getListByKey
Method post
Content-Type application/json

请求参数:

参数名称 是否必选 数据类型 数据约束 示例数据 描述
object_id string --- --- 编号
page_index string --- --- 页数
page_size string --- --- 每页条数
start_time string --- --- 开始时间
end_time string --- --- 结束时间
resample string --- "3" 时间间隔
keys []string --- ["S06", "S07"] FV列表

响应参数:

参数名称 是否必选 数据类型 描述
code int 返回码
msg string 提示消息
info string 详细信息
result object 返回结果

请求示例

curl -H "Content-Type: application/json" -X POST "https://xxx.mixiot.top/hapim/api/v1/mosaic/getListByKey?object_id=1&page_index=1&page_size=5&start_time=2020-10-13T09:40:42Z&end_time=2020-10-13T16:41:22Z&resample=3&keys=["S06", "S07"]

返回示例:

{
    "code": 200,
    "msg": "成功",
    "info": "",
    "result": {
        "data": [
            {
                "time": "2020-10-13 16:26:42",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:33",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:21",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:12",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            },
            {
                "time": "2020-10-13 16:26:03",
                "value": {
                    "S06": "36",
                    "S07": null
                }
            }
        ],
        "page_index": 1,
        "page_size": 5,
        "total_pages": 947,
        "total_records": 4735
    }
}
© Mixlinker all right reserved,powered by Gitbook文件修订时间: 2021-03-05 16:09:24

results matching ""

    No results matching ""