查询一批设备/资产的指定时间范围内的维保信息（如果传的时间为空则查询所有历史的）

POST

/api/v1/iot/maintenance/get-by-time

DeviceMaintenance

根据设备Id、资产Id来查询维修保养记录。开始时间和结束时间均可为空，如果开始时间为空，则查询的记录为保养时间在结束时间之前的所有记录，同理，如果结束时间为空，则查询的记录为保养时间在开始时间之后的所有记录，开始结束时间均为空时，则查询所有记录。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

entityIds

array[string <uuid>] | null

设备或资产的Id

可选

startTime

string <date-time> | null

查询的开始时间

可选

endTime

string <date-time> | null

查询的结束时间

可选

示例

{
    "entityId": "938afbf0-a768-11ed-b61a-796f4bd37bcb",
    "startTime": "2023-03-01 13:06:01.146Z",
    "endTime": "2023-03-02 13:06:01.146Z"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://online-products.dhichina.cn/gateway/iot-service/api/v1/iot/maintenance/get-by-time' \
--header 'Content-Type: application/json' \
--data-raw '{
    "entityId": "938afbf0-a768-11ed-b61a-796f4bd37bcb",
    "startTime": "2023-03-01 13:06:01.146Z",
    "endTime": "2023-03-02 13:06:01.146Z"
}'

返回响应

🟢200成功

text/plain

Success

Body

array of:

entityId

string <uuid>

设备或资产Id

可选

entityType

enum<integer> <int32>

可选

0-TENANT_PROFILE(租户配置实体)
1-TENANT(租户实体)
2-CUSTOMER(客户实体)
3-DEVICE(设备实体)
4-ASSET(资产实体)
5-DEVICE_PROFILE(资产实体)

枚举值:

012345

maintenance

string | null

维修或保养的内容

可选

time

string <date-time>

维护或保养的时间

可选

string <uuid>

记录Id

可选

示例

成功示例异常示例

[
    {
        "entityId": "938afbf0-a768-11ed-b61a-796f4bd37bcb",
        "entityType": 3,
        "maintenance": "数据标定_test",
        "time": "2023-03-01 13:06:01.146Z",
        "id": "c5f55928-faf8-722e-7e02-7decf0b05cc2"
    },
    {
        "entityId": "938afbf0-a768-11ed-b61a-796f4bd37bcb",
        "entityType": 3,
        "maintenance": "数据标定",
        "time": "2023-03-01 14:06:01.146Z",
        "id": "3a09b343-403f-88cc-91d7-206f5d3386a8"
    }
]

根据设备Id、资产Id来查询最新的维修保养信息

历史数据查询