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
}