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