Get started
  • English
  • 简体中文
Official Site
Get started
  • English
  • 简体中文
Official Site
  • Get started
  • Concepts
  • Guides
  • Device capabilities & events
  • API reference
    • Public conventions
    • Development specification
    • accessToken: Get administrator token
    • API request example
    • Return codes
    • Interface call limits
    • Account docking
    • Device APIs
      • bindDevice: Bind Device
      • unBindDevice: Unbind Device
      • Batch detail by device ID
      • Paged device detail
      • Query online status
      • Pre-bind information
      • Bind state
      • subAccountDeviceInfo
      • subAccountDeviceList
      • setDeviceSnap: Device snapshot
      • setDeviceSnapEnhanced: Device snapshot
      • timeZoneConfigByDay: Set Device Time Zone Daylight Saving Time (by time)
      • timeZoneConfigByWeek: Setting device time zone daylight saving time (per week)
      • timeZoneQueryByDay: Query device time zone daylight saving time (by date)
      • timeZoneQueryByWeek: Obtain device time zone daylight saving time (by week)
    • Device live broadcast
    • Push configuration
    • Cloud storage service
    • Resource pool quota
    • Legacy APIs (deprecated)
  • SDK and tools
  • Solutions
  • Platform and support
On this page
Function details
Request address
Request format
Input parameter note
Error codes
Related

timeZoneConfigByWeek (timeZoneConfigByWeek: Setting device time zone daylight saving time (per week))

timeZoneConfigByWeek: timeZoneConfigByWeek: Setting device time zone daylight saving time (per week)

Previous: timeZoneConfigByDay · Next: timeZoneQueryByDay · Time zone and DST.

Function details

Setting device time zone daylight saving time (per week).

Request address

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

Request format

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

Input parameter note

Parameter ListNoteParameter TypeMandatoryDefault ValidityLegal value
tokenaccessToken or userTokenStringY
deviceIdDevice IDStringY
areaIndexSet time zone corresponding to the index value (please specify corresponding to the following table Settings)StringY
timeZoneTime zone of the device (please refer to the following table Settings for details)StringY
beginSunTimeDaylight saving time start timeStringNbeginSunTime and endSunTime no value means close daylight saving time
endSunTimeDaylight saving time end timeStringNbeginSunTime and endSunTime no value means close daylight saving time

Sample input

{
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031074,
 "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
 },
 "params": {
 "token":"At_12345678901234567890123456789012", // accessToken or userToken
 "deviceId":"TESTQWERXXXX-dfXXX-XX", //Device ID
 "areaIndex":"1",
 "timeZone":"8",
 "beginSunTime":"3-1-1 18:59:20",//The start time of daylight saving time, which means "the day of a month - the day of the month - the day of the week, in minutes.No value means close daylight saving time
 "endSunTime":"3-1-1 18:59:20"//The end time of daylight saving time, which means "the day of a month - the day of the month - the day of the week, in minutes.No value means close daylight saving time
 }
}

Sample output

{

"id":"123456",
"result": {
 "code":"0",
 "msg":"Operation is successful."
}

}

Return result

Error codeDescription
0Operation is successful.
SN1001Abnormal signature
SN1002Signature timeout
SN1003Signature parameter error
OP1002Parameter missing, please confirm parameter
OP1003Invalid parameter (incorrect or null), please modify parameter
OP1007Invalid method call
OP1009No right, cannot operate
OP1010Application is frozen
OP1011Today's call interface reach limit
TK1002Token expired or does not exist, please get token again
TK1003Invalid token, please upload correct token
DV1007Device offline

AreaIndex, timeZone correspondence:

areaIndextimeZonecity
032international date line West
131-11 UTC
230Hawaii
329Alaska
428Pacific time (United States and Canada)
528Baja California
627Chihuahua, La Paz, Mazatlan
727Mountain time (United States and Canada)
827Arizona
926Guadalajara, Mexico City, Monterrey
1026Saskatchewan
1126Central time (United States and Canada)
1226Central America
1325Bogota, Lima
1425Eastern time (United States and Canada)
1525Indiana (East)
1624Caracas
1724Atlantic time (Canada)
1824Cuiaba
1924Georgetown, La Paz, Manaus, San Juan
2024San Diego
2124Asunción
2223Newfoundland
2322Brasilia
2422Buenos Aires
2522Greenland
2622Cayenne, Fortaleza
2722Montevideo-Asian
2822El Salvador
2921-02 UTC
3021mid-Atlantic
3120Cape Verde Islands
3220Azores
330Dublin, Edinburgh, Lisbon, London
340Casablanca
350mengluoweiya, Reykjavik
360coordinated universal time
371Tripoli
381Amsterdam, Berlin, Bern, Rome, sitegeermo, Viana do Castelo
391Belgrade, buladesilafa, Budapest, lubueryana, Prague
401Brussels, Copenhagen, Madrid, Paris
411Sarajevo, Skopje, Warsaw, Zagreb
421Windhoek
431West Central Africa
442Beirut
452Damascus
462Eastern Europe
472Harare, Pretoria
482Helsinki, base shop, Riga, Sofia, Tallinn, Vilnius
492Cairo
502Athens, Bucharest
512+02 UTC
523yisitabuer
533Amman
543Baghdad
553Kaliningrad, Minsk
563Kuwait, Riyadh
573Nairobi
584Tehran
595Abu Dhabi, Muscat
605Yerevan
615Baku
625Tbilisi
635Port Louis
643Moscow, St Petersburg, Volgograd
656Kabul
667asihabade, Marrakech
677Islamabad, Karachi
688Chennai, Kolkata, Mumbai, New Delhi
698silijiaya Worcester lamp Pula
709Kathmandu
7110Astana
7210Dhaka
7310Yekaterinburg
7411Yangon
7512Bangkok, Hanoi, Jakarta
7612Novosibirsk
7713Beijing, Chongqing, Hong Kong S.A.R., Urumqi
7813Kuala Lumpur, Singapore
7913Krasnoyarsk
8013Perth
8113Chinese Taipei
8213Ulan Bator
8314Osaka, Sapporo, Tokyo
8414Seoul
8514Il Yakutsk
8615Adelaide
8715Darwin
8816Brisbane
8916Guam, Port Moresby
9016Hobart
9116Canberra, Melbourne, Sydney
9216James Yakutsk
9317Vladivostok
9417Solomon Islands, xinhaliduoniya
9517Magadan
9618Auckland, Wellington
9718Fiji
9818+12 UTC
9919Nukualofa
10019Samoa

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)

CodeMeaningNext step
SN1001Signature errorCheck sign per Development specification
TK1002Token invalid or expiredRefresh accessToken
OP1002Missing required parameterAdd required fields
OP1003Invalid parameterMatch this page’s parameter table
OP1009Permission deniedCheck token and device bind/share grants
OP1013Total call limit exceededReduce call rate
OP1014Daily per-interface limit exceededSee Interface call limits
DV1007Device offlineWait until the device is online

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

Sub-accounts (SUB)

CodeMeaningNext step
SUB1001–SUB1002Sub-account lacks API permissionUpdate policy via addPolicy
SUB1005Sub-account token expiredRefresh subAccountToken
SUB1006No device grant for sub-accountCheck Resource and device serial
SUB1008Sub-account not bound to appCreate and bind the sub-account first

See Return codes · SUB.

Device access and channels (DV10xx)

CodeMeaningNext step
DV1007Device offline or timeoutWait for the device to come online
DV1009Device busyRetry later
DV1012Insufficient share/grant permissionCheck sub-account Permission / Resource
DV1019Capability not supportedConfirm model and capability list
DV1020Channel offlineCheck channel status
DV1026Function not supportedUse another API or upgrade firmware
DV1028Not bound or channel missingVerify deviceId / channelId

See Return codes · DV.

Related

  • Development specification
  • API conventions
  • Module index
timeZoneConfigByDay: Set Device Time Zone Daylight Saving Time (by time)
timeZoneQueryByDay: Query device time zone daylight saving time (by date)