Machine Status Change Records

POST

/api/user_devices/time_periods

Function Introduction

Used to query the status change records of authenticated machines within a specified time period.

Notes

cardId ① Needs to be the control card ID of the authenticated machine; ② Needs to be the control card ID within the user device quota.

The difference between startTime and endTime should not exceed one day and must be within the same day.

Only saves records of the machine for the last 100 days.

Request

Header Params

Body Params application/json

Example

{
    "cardId": "1234567890",
    "startTime": "2023-11-17 00:00:00",
    "endTime": "2023-11-17 23:59:59"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/user_devices/time_periods' \
--header 'app-id: op188b25734a433a79' \
--header 'time-stamp: 1701055999133' \
--header 'app-sign: 6829d50c9e68138b109d5ae040d48166' \
--header 'zoneId: America/Chicago' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardId": "1234567890",
    "startTime": "2023-11-17 00:00:00",
    "endTime": "2023-11-17 23:59:59"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 0,
    "msg": "OK",
    "data": [
        {
            "time": 21600,
            "timeStart": "2023-11-17 00:00:00",
            "timeEnd": "2023-11-17 06:00:00",
            "status": "OFFLINE"
        },
        {
            "time": 21600,
            "timeStart": "2023-11-17 06:00:00",
            "timeEnd": "2023-11-17 12:00:00",
            "status": "IDLE"
        },
        {
            "time": 21600,
            "timeStart": "2023-11-17 12:00:00",
            "timeEnd": "2023-11-17 18:00:00",
            "status": "WORK"
        },
        {
            "time": 3600,
            "timeStart": "2023-11-17 18:00:00",
            "timeEnd": "2023-11-17 19:00:00",
            "status": "PAUSE"
        },
        {
            "time": 3600,
            "timeStart": "2023-11-17 19:00:00",
            "timeEnd": "2023-11-17 20:00:00",
            "status": "ALARM"
        },
        {
            "time": 3600,
            "timeStart": "2023-11-17 20:00:00",
            "timeEnd": "2023-11-17 21:00:00",
            "status": "PLC"
        },
        {
            "time": 10799,
            "timeStart": "2023-11-17 21:00:00",
            "timeEnd": "2023-11-17 23:59:59",
            "status": "UNKNOWN"
        }
    ]
}

Modified at 2024-10-09 01:59:09

Machine Detailed Information

Machine Operating Status