5.1.5 api system time

Funkce /api/system/time slouží k získání o čase zařízení nebo k nastavení času.

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 reálný čas v zařízení v sekundách od 00:00 1.1.1970 (unix time).

GET /api/system/time
{
  "success" : true,
  "result" : {
    "utcTime" : 1639472172,
    "source" : "My2N",
    "automatic" : true,
  }
}

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í).

Upozornění

  • Doporučujeme používat tento endpoint k nastavení času zařízení jen v případě, že parametr Použít čas z internetu je vypnutý. V případě, že je tento parametr zapnutý, čas bude přepsán časem z NTP serveru nebo z časové služby My2N.

Parametry požadavku pro metodu PUT:

Parametr

Popis

automatic

Automatické získávání času z NTP serveru

Při vyplnění hodnoty true se další parametry nezadávají.

utcTime

číslo = unixový čas, min. BuildTime, max. 2147483647 

server

adresa NTP serveru (IPv4 adresa nebo doména)

Odpověď pro metodu PUT je ve formátu application/json.

PUT /api/system/time?automatic=0&server=pool.ntp.org&utcTime=1700829813
{
  "success" : true,
}