Ďakujeme za vašu spätnú väzbu.
Spätná väzba?
Pomocou makier môžete kedykoľvek odosielať dáta na server HTTP (S). Máte kontrolu nad tým, aké údaje sa odosielajú a ako sú organizované, čo uľahčuje prispôsobenie údajov na použitie s existujúcimi službami.
Bezpečnostné opatrenia:
-
Funkcia požiadavky klienta HTTP (S) je predvolene zakázaná. Správca systému musí túto funkciu výslovne povoliť nastavením de na Zapnuté (
XConfiguration HttpClient Mode:Zapnuté). -
Správca systému môže zabrániť použitiu HTTP nastavením Htt : False).
-
Správca systému môže určiť zoznam serverov HTTP (S), na ktoré môže zariadenie odosielať údaje. (Pozrite si príkazy
XCommand HttpClient Povoliť názov hostiteľa.) -
Počet súbežných požiadaviek HTTP (S) je obmedzený.
Konfigurácie uvedené v tomto článku sú k dispozícii z webového rozhrania zariadenia aj v rozhraní API. Príkazy sú k dispozícii prostredníctvom rozhrania API. Prečítajte si článok Rozšírené nastavenia, kde nájdete informácie o tom, ako získať prístup k webovému rozhraniu a používať rozhranie API.
Zoznam povolených serverov HTTP (S)
Správca systému môže pomocou týchto príkazov nastaviť a udržiavať zoznam až desiatich povolených serverov HTTP (S) (hostiteľov):
-
XCommand HttpClient Povoliť názov hostiteľa Pridať výraz:<Regular expression that matches the host name or IP address of the HTTP (S) server> -
XCommand HttpClient Povoliť názov hostiteľa Vymazať -
XCommand HttpClient Povoliť zoznam názvov hostiteľa -
XCommand HttpClient Allow Hostname Odstrániť ID:<id of an entry in the list>
Ak zoznam obsahuje položky servera, môžete odosielať iba požiadavky HTTP (S) na tieto servery. Ak je však zoznam prázdny, môžete odoslať požiadavky na ľubovoľný server HTTP (S).
Kontrola zoznamu povolených serverov sa vykonáva tak pri použití nezabezpečeného (HTTP), ako aj zabezpečeného (HTTPS) prenosu dát.
HTTPS bez overenia certifikátu
Pri odosielaní požiadaviek cez HTTPS zariadenie predvolene skontroluje certifikát servera HTTPS. Ak sa nezistí, že certifikát servera HTTPS je platný, zobrazí sa chybové hlásenie. Zariadenie na tento server neodosiela žiadne údaje.
Odporúčame používať HTTPS s overovaním certifikátov. Ak overovanie certifikátu nie je možné, správca systému môže nastaviť Zapnuté). To umožňuje použitie HTTPS bez overenia certifikátu servera.
Odosielanie HTTP (S) požiadaviek
Po povolení funkcie požiadavky klienta HTTP (S) môžete na odosielanie požiadaviek na server HTTP (S) použiť nasledujúce príkazy.
<method>je buď U
verejniť
,
Umiest
niť,
Opraviť
,
Získ ať alebo Od
strániť
.
-
XCommand HttpClient [AllowInsecureHttps:] [Hlavička:] [ResponseSizeLimit:] [ResultBody:] [Časový limit:] Url:<Method><True/False> <Header text><Maximum response size><None/PlainText/Base64> <Timeout period><URL to send the request to>
Pridanie polí hlavičky je voliteľné a môžete pridať až 20 polí.
Paramet
er allowInsecureHTTPS má účinok iba vtedy, ak správca systému povolil používanie protokolu HTTPS bez overenia certifikátu servera. Ak áno, môžete odoslať údaje na server bez overenia certifikátu servera, ak je parameter nastavený na hodnotu
True
. Ak parameter vynecháte alebo ho nastavíte na hodnotu
Fal se
, údaje sa neodošlú, ak overenie certifikátu zlyhá.
Parameter
ResposensizeLimit je maximálna veľkosť užitočného zaťaženia (bajty), ktorú zariadenie prijíma ako odpoveď zo servera. Ak je užitočná odpoveď väčšia ako táto maximálna veľkosť, príkaz vráti chybu stavu. Chybové hlásenie hovorí, že maximálna veľkosť súboru je prekročená. To však nemá žiadny vplyv na stranu servera; server prijal a spracoval požiadavku správne.
Pomocou
parametra
ResultBody sa rozhodne, ako formátovať telo odpovede HTTP zo servera vo výsledku príkazu. Máte tri možnosti:
-
Žiadne: Nezahŕňajte telo odpovede HTTP do výsledku príkazu. -
Base64: Base64 zakóduje telo pred jeho zahrnutím do výsledku. -
PlainText: Zahrňte telo do výsledku ako obyčajný text. Ak odpoveď obsahuje písmená, ktoré nie je možné vytlačiť, príkaz vráti chybu stavu so správou, že sa vyskytli údaje, ktoré nie je možné vytlačiť.
Pomocou
parametra
Timeout nastavte časové obdobie (sekundy). Ak žiadosť počas tohto obdobia nie je dokončená, rozhranie API vráti chybu.
Zadajte užitočné zaťaženie (údaje) hneď po vydaní príkazu. Čokoľvek, čo zadáte, vrátane prerušení riadkov, je súčasťou užitočného zaťaženia. Po dokončení dokončite prerušením riadku („\n“) a samostatným riadkom obsahujúcim iba bodku, po ktorej nasleduje prerušenie riadku (“. \n“). Teraz sa príkaz vykoná a údaje sa odošlú na server.
Príklady
Telo správy je v oboch týchto príkladoch JSON. Môže to byť akýkoľvek formát v závislosti od očakávaného formátu služby, ktorá prijíma správy.
Príklad 1: Ovládanie zariadení IoT pomocou HTTP Post
Tu je funkcia makra, ktorá zapne svetlo pripojené k mostu Philips Hue:
function hue_command(data) { var url = 'http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state'; var headers = 'Content-Type: application/json'; var command = '{"on":true}'; xapi.command('HttpClient Put', { 'Url': url, 'Header': headers }, command); }
To isté môžete urobiť v príkazovom riadku pomocou rozhrania API:
xcommand HttpClient Put Header: "Content-Type: application/json" URL: "http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state" {"on":true} .
Príklad 2: Uverejňovanie údajov do monitorovacieho nástroja pomocou HTTP Post
xcommand HttpClient Post Header: "Content-Type: application/json" URL: "https://mymonitoringserver.com/service/devicemonitoring" {"Message":"A user reported an issue with this system","systemName":"BoardRoom 4th floor","softwareVersion":"ce9.6.0","softwareReleaseDate":"2018-12-13","videoMonitors":"Dual"} .
Ďalšie informácie
Ďalšie podrobnosti o používaní požiadaviek klienta HTTP nájdete v príručke Prispôsobenie . Vyberte si najnovšiu verziu.
Podpora Cisco (TAC) nepodporuje ladenie kódu tretích strán vrátane makier. Ak potrebujete pomoc s makrami a kódom tretích strán, skontrolujte https://roomos.cisco.com.
