device.timezonerule.get (Query daylight saving rules)

device.timezonerule.get: Query daylight saving rules

What it does

Not a device operation. No deviceId. Queries the platform region time zone and daylight saving rule table. This method does not appear in device.capability.list.

Request URL

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.timezonerule.get

Minimum permission

Account-level platform rule query: only a valid token is required (administrator / sub-user / sub-account). No device binding or share permission check; unrelated to device Config.

Request parameters

Name	Type	Required	Default	Legal values	Description
`token`	String	yes			Access token for an administrator, sub-user, or sub-account
`areaName`	String	yes		IANA region name	e.g. `Asia/Shanghai`

For common request fields and signing, see Signing conventions and Common request payload.

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "areaName": "Asia/Shanghai"
 }
}

Response data fields

Name	Type	Description
`deviceArea`	Object	Region rules
`deviceArea.areaName`	String	Time zone name
`deviceArea.deviceInfo`	String	Time zone rules as a JSON string

Response example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "result": {
 "code": "0",
 "msg": "Operation is successful",
 "data": {
 "deviceArea": {
 "areaName": "Asia/Shanghai",
 "deviceInfo": "{\"offset\":\"+08:00\"}"
 }
 }
 }
}

Error codes

This API may return the codes below.

This API does not access the device.

Gateway