timeZoneQueryByWeek (timeZoneQueryByWeek: Obtain device time zone daylight saving time (by week))

timeZoneQueryByWeek: timeZoneQueryByWeek: Obtain device time zone daylight saving time (by week)

Previous: timeZoneQueryByDay · Time zone and DST.

Function details

Obtain device time zone daylight saving time (by week).

Request address

https://openapi-[DataCenter].easy4ip.com/openapi/timeZoneQueryByWeek

Request format

HTTP POST. JSON body layout: Request conventions. Sign with Signature.

Input parameter note

Parameter List	Note	Parameter Type	Mandatory	Default Validity	Legal value
token	accessToken or userToken	String	Y
deviceId	Device ID	String	Y

Sample input

{
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031074,
 "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
 },
 "params": {
 "token":"At_12345678901234567890123456789012",
 "deviceId":"TESTQWERXXXX-dfXX-XX"
 }
}

Return data field description

Field name	Field type	Field description
areaIndex	String	Time zone area index (may be omitted)
timeZone	String	Device time zone; if omitted, the device's current configuration applies
beginSunTime	String	Daylight saving start time as `month-day-weekday hour:minute:second`; empty means DST disabled
endSunTime	String	Daylight saving end time, same format as `beginSunTime`; empty means DST disabled

Sample output

{

"id":"123456",

"result":{

 "data":{
 "areaIndex":"1",
 "timeZone":"8",
 "beginSunTime":"3-1-1 18:59:20",
 "endSunTime":"3-1-1 18:59:20"
 },

 "code":"0",

 "msg":"Operation is successful."

}

}

Return result

Error code	Description
0	Operation is successful.
SN1001	Abnormal signature
SN1002	Signature timeout
SN1003	Signature parameter error
OP1002	Parameter missing, please confirm parameter
OP1003	Invalid parameter (incorrect or null), please modify parameter
OP1007	Invalid method call
OP1009	No right, cannot operate
OP1010	Application is frozen
OP1011	Today's call interface reach limit
TK1002	Token expired or does not exist, please get token again
TK1003	Invalid token, please upload correct token
DV1007	Device offline

Error codes

This method may return the codes below. See Return codes and Capability errors for the full catalog.

Gateway and auth (SN / TK / OP)

Code	Meaning	Next step
`SN1001`	Signature error	Check `sign` per Development specification
`TK1002`	Token invalid or expired	Refresh accessToken
`OP1002`	Missing required parameter	Add required fields
`OP1003`	Invalid parameter	Match this page’s parameter table
`OP1009`	Permission denied	Check token and device bind/share grants
`OP1013`	Total call limit exceeded	Reduce call rate
`OP1014`	Daily per-interface limit exceeded	See Interface call limits
`DV1007`	Device offline	Wait until the device is online

See Return codes · OP/SN/TK for the full catalog.

Sub-accounts (SUB)

Code	Meaning	Next step
`SUB1001`–`SUB1002`	Sub-account lacks API permission	Update policy via addPolicy
`SUB1005`	Sub-account token expired	Refresh subAccountToken
`SUB1006`	No device grant for sub-account	Check `Resource` and device serial
`SUB1008`	Sub-account not bound to app	Create and bind the sub-account first

See Return codes · SUB.

Device access and channels (DV10xx)

Code	Meaning	Next step
`DV1007`	Device offline or timeout	Wait for the device to come online
`DV1009`	Device busy	Retry later
`DV1012`	Insufficient share/grant permission	Check sub-account `Permission` / `Resource`
`DV1019`	Capability not supported	Confirm model and capability list
`DV1020`	Channel offline	Check channel status
`DV1026`	Function not supported	Use another API or upgrade firmware
`DV1028`	Not bound or channel missing	Verify `deviceId` / `channelId`

See Return codes · DV.