5.1.7 api system timezone
Funkce /api/system/timezone slouží k získání informací o časové zóně zařízení nebo k nastavení časové zóny.
Pro tuto funkci lze použít metodu GET k získání informací nebo PUT k nahrání konfigurace.
Metoda GET
Funkce je součástí služby System a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Systém (sledování).
Pro metodu GET nejsou definovány žádné parametry.
Odpověď je ve formátu application/json a obsahuje informace, zda je tato zóna nastavena automaticky a jaká časová zóna je nastavena. V případě, že je časová zóna zadaná manuální volbou, je v parametru custom zobrazeno pravidlo, podle kterého byla zóna nastavena.
Příklad
GET /api/system/timezone { "success": true, "result": { "automatic": true, "zone": "America/Los Angeles" } } nebo { "success": true, "result": { "automatic": false "zone": "custom", "custom": "UTC-08:00" } }
Metoda PUT
Funkce je součástí služby System a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Systém (řízení).
Parametry požadavku pro metodu PUT:
Parametr | Popis |
---|---|
automatic | 0 nebo 1 Při vyplnění hodnoty true (1) se další parametry nezadávají. |
zone | Definuje zónu. Lze zadat buď název zóny nebo "custom" pro umožnění manuálního zadání zóny. Seznam názvů zón je na endpointu 5.1.8 api system timezone caps. |
custom | Definuje zónu vlastním zapsáním ve formátu UTC−08:00, UTC+03:00 apod. Je možné použít pouze při zone="custom". |
Příklad
PUT /api/system/timezone?automatic=0&zone=custom&custom=UTC-08:00 { "success" : true }