The content of this page has been automatically translated by AI. If you encounter any problems while reading, you can view the corresponding content in Chinese.
Help & Documentation>IoT Explorer>Application Side API>Device Scheduling>Get Scheduled Task List

Get Scheduled Task List

Last updated: 2025-04-30 15:43:49

On this page:

1. API Description

api request domain name: iot.cloud.tencent.com/api/exploreropen/tokenapi. This interface (AppGetTimerList) is used to obtain the timer list.

2. Input Parameter

Name
Type
Required
Description
AccessToken
String
Yes
Common parameter. AccessToken is used for user authentication of a logged-in user.
RequestId
String
Yes
Common parameter. Unique request ID can be generated manually. It is recommended to use uuid. When locating issues, provide the RequestId for the request.
Action
String
Yes
Common parameter. This interface takes values AppGetTimerList.
ProductId
String
Yes
Product ID needed to get the scheduled task list.
DeviceName
String
Yes
Device name needed to get the scheduled task list.
Offset
Int
No
The list offset obtained.
Limit
Int
No
The total obtained message count, with a maximum of 50.

3. Output Parameter

Name
Type
Description
RequestId
String
Common parameter. Unique request ID, same as the input parameter. When locating issues, provide the RequestId for the request.
TimerList
Array
The obtained product list. Please see TimerList.
Total
Int
Total number of items owned.

4. Samples

Input Example
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
    "RequestId": "req_1",
    "Action": "AppGetTimerList",
    "ProductId": "US4*****IK",
    "DeviceName": "411_3",
    "Offset":0,
    "Limit":2,
    "AccessToken": "c1******************847e"
}
Output sample: successful
{
    "Response": {
        "RequestId": "req_1",
        "Total":2,
        "TimerList": [{
            "TimerId": "a1c6939b39d345b897**********a12c",
            "TimerName": "timer_test_modify",
            "ProductId": "US4*****IK",
            "DeviceName": "411_3",
            "Days": "1100000",
            "TimePoint": "09:30",
            "Repeat": 0,
            "Data": "{\"brightness\": 28}",
            "Status": 0,
            "CreateTime": 1570786578,
            "UpdateTime": 1570790807
        }, {
            "TimerId": "f888dd20c70744939a**********1c3a",
            "TimerName": "timer_test",
            "ProductId": "US4*****IK",
            "DeviceName": "411_3",
            "Days": "1000000",
            "TimePoint": "07:00",
            "Repeat": 1,
            "Data": "{\"brightness\": 25}",
            "Status": 1,
            "CreateTime": 1570786483,
            "UpdateTime": 1570786483
        }]
    }
}

5. Error Code

Error Code
Description
InternalError
Internal error.
InvalidParameterValue
Invalid parameter value.
InvalidParameterValue.InvalidAccessToken
The Token is invalid.

中国站 - English