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, }