Obtaining Control Command Execution Logs

TIP

This interface is used for obtaining the command execution history of a player.

Sub-accounts can only manage data within their specific workgroup and its sub-workgroups.

Advanced interface.

Request

Body Params application/json

playerId

string

required

Player IDs to be handled. Only a single player can be queried.

count

integer

required

Items of each type of historical data that can be read each time, 20 by default, range: 1~100

start

integer

required

From which item to start reading each type of historical data, 0 by default

taskType

integer

required

1: Restart, 2: Screen status control, 4: Video source switching, 3: Synchronous playback, 5: Upgrade, 6: Screenshot, 7: Time zone, 8: Power control, 9: Volume adjustment 10: Brightness adjustment

Example

{
   "playerId": "df6c02352e4fd3cd5bc664fcdaef29c9",
   "count": 20,
   "start": 0,
   "taskType": 1
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

total

integer

required

Total number of items of history

rows

array [object {4}]

required

Historical array

status

string

optional

Command execution result, 0: Unknown 1: Successful 2: Failed

executeTime

string

optional

Command execution time

type

string

optional

Command type reboot-Restart、openScreen-Turn on screen、closeScreen-Turn off screen、openSyncPlay-Turn on synchronous playback、closeSynsPlay-Turn off synchronous playback、internal-Internal video source、HDMI-External video source、osUpdate-OS update、appUpdate-APP update、firmwareUpdate-Firmware update、screenShot-Screenshot、getTimezone-Get time zone、setTimezone-Set time zone、setVolume-Set time zone、setBrightness-Set brightness

ratio

integer

optional

Specified volume or brightness. This is not available for other types of commands.

Example

{
    "total": 3,
    "rows": [
        {
            "status": 1,
            "executeTime": "2024-07-02 04:55:48",
            "type": "openScreen"
        },
        {
            "status": 1,
            "executeTime": "2024-07-02 04:55:33",
            "type": "openScreen"
        },
        {
            "status": 1,
            "executeTime": "2024-07-02 04:55:16",
            "type": "openScreen"
        }
    ]
}