2. Popis protokolu HTTP API
Všechny příkazy HTTP API jsou odesílány pomocí HTTP nebo HTTPS protokolu na adresu interkomu s absolutní cestou doplněným prefixem /api. Volba protokolu závisí na aktuálním nastavení interkomu v sekci Služby / HTTP API. Funkce HTTP API jsou rozděleny do služeb a u každé služby je možné nastavit požadovanou úroveň zabezpečení včetně požadavku na TLS spojení (tj. HTTPS protokol)
Příklad: Sepnutí spínače 1 http://10.0.23.193/api/switch/ctrl?switch=1&action=on
Absolutní cesta obsahuje název skupiny funkcí (systém, firmware, config, switch apod.) a název funkce samotné (caps, status, ctrl apod.).
Minimalistická varianta požadavku akceptovaná interkomem musí obsahovat řádek požadavku s metodou a absolutní cestou následovaný hlavičkou Host:
Příklad:
GET /api/system/info HTTP/1.1 Host: 10.0.23.193 HTTP Server interkomu odpoví zprávou: HTTP/1.1 200 OK Server: HIP2.10.0.19.2 Content-Type: application/json Content-Length: 253 { "success" : true, "result" : { "variant" : "2N IP Vario", "serialNumber" : "08-1860-0035", "hwVersion" : "535v1", "swVersion" : "2.10.0.19.2", "buildType" : "beta", "deviceName" : "2N IP Vario" } }
V této kapitole dále naleznete: