Hvala na povratnim informacijama.
Želite li poslati povratne informacije?
Pomoću makronaredbi možete slati podatke na HTTP (S) poslužitelj kad god trebate. Imate kontrolu nad podacima koji se šalju i kako su organizirani, što olakšava prilagođavanje podataka za upotrebu s postojećim uslugama.
Sigurnosne mjere:
-
Značajka zahtjeva HTTP (S) klijenta je prema zadanim postavkama onemogućena. Administrator sustava mora izričito omogućiti značajku postavljanjem de na Uključeno (
XConfiguration HttpClient Mode:Uključeno). -
Administrator sustava može spriječiti upotrebu HTTP-a postavljanjem Htt : False).
-
Administrator sustava može odrediti popis HTTP (S) poslužitelja na koje je uređaju dopušteno slati podatke. (Pogledajte
naredbe XCommand HttpClient Dopusti ime hosta.) -
Broj istodobnih HTTP (S) zahtjeva je ograničen.
Konfiguracije navedene u ovom članku dostupne su i s web sučelja uređaja i u API-ju. Naredbe su dostupne putem API-ja. Pročitajte članak Napredne postavke za informacije o tome kako pristupiti web sučelju i koristiti API.
Popis dopuštenih HTTP (S) poslužitelja
Administrator sustava može koristiti ove naredbe za postavljanje i održavanje popisa do deset dopuštenih HTTP (S) poslužitelja (hostova):
-
XCommand HttpClient Dopusti ime hosta Dodaj izraz:<Regular expression that matches the host name or IP address of the HTTP (S) server> -
XCommand HttpClient Dopusti ime hosta Obriši -
XCommand HttpClient Dopusti popis imena hosta -
XCommand HttpClient Dopusti ime hosta Ukloni ID:<id of an entry in the list>
Ako popis sadrži unose poslužitelja, na te poslužitelje možete slati samo HTTP (S) zahtjeve. Međutim, ako je popis prazan, možete slati zahtjeve bilo kojem HTTP (S) poslužitelju.
Provjera popisa dopuštenih poslužitelja vrši se i kada se koristi nesiguran (HTTP) i siguran (HTTPS) prijenos podataka.
HTTPS bez provjere potvrde
Prilikom slanja zahtjeva putem HTTPS-a uređaj provjerava certifikat HTTPS poslužitelja prema zadanim postavkama. Ako se utvrdi da certifikat HTTPS poslužitelja nije valjan, dobit ćete poruku o pogrešci. Uređaj ne šalje nikakve podatke na taj poslužitelj.
Preporučujemo korištenje HTTPS-a s provjerenošću certifikata. Ako provjera potvrde nije moguća, administrator sustava može postaviti On). To omogućuje korištenje HTTPS-a bez provjere potvrde poslužitelja.
Slanje HTTP (S) zahtjeva
Nakon što je omogućena značajka zahtjeva HTTP (S) klijenta, možete upotrijebiti sljedeće naredbe za slanje zahtjeva na HTTP (S) poslužitelj.
<method>je Objav
ljivanje
,
stavljanje
,
zakr
panje
,
dobi vanje ili
brisan je
.
-
XCommand HttpClient [AllowInsecureHttps:] [Zaglavlje:] [ResponseSizeLimit:] [ResultBody:] [Time-out:] Url:<Method><True/False> <Header text><Maximum response size><None/PlainText/Base64> <Timeout period><URL to send the request to>
Dodavanje polja zaglavlja nije obavezno, a možete dodati do 20 polja.
Parametar
AllowInsecureHTTPS ima učinak samo ako je administrator sustava dopustio upotrebu HTTPS-a bez provjere potvrde poslužitelja. Ako je to slučaj, možete poslati podatke poslužitelju bez provjere potvrde poslužitelja ako je parametar postavljen na
True
. Ako izostavite parametar ili ga postavite na
Fal se
, podaci se neće slati ako provjera potvrde ne uspije.
Parametar
RespoSensizeLimit je maksimalna veličina korisnog tereta (bajtovi) koju uređaj prihvaća kao odgovor poslužitelja. Ako je korisni teret odgovora veći od ove maksimalne veličine, naredba vraća statusnu pogrešku. Poruka o pogrešci kaže da je prekoračena maksimalna veličina datoteke. Međutim, to nema utjecaja na stranu poslužitelja; poslužitelj je pravilno primio i obradio zahtjev.
Pomoću
parametra
ResultBody odlučite kako formatirati tijelo HTTP odgovora s poslužitelja u rezultatu naredbe. Imate tri opcije:
-
Nema: Ne uključujte tijelo HTTP odgovora u rezultat naredbe. -
Base64: Base64 kodira tijelo prije nego što ga uključite u rezultat. -
PlainText: Uključite tijelo u rezultat kao običan tekst. Ako odgovor sadrži slova koja se ne mogu ispisati, naredba vraća statusnu pogrešku s porukom koja kaže da su naišli na podatke koji se ne mogu ispisati.
Pomoću
parametra
Timeout postavite vremensko razdoblje (sekunde). Ako zahtjev nije dovršen tijekom tog razdoblja, API vraća pogrešku.
Unesite korisni teret (podatke) odmah nakon što ste izdali naredbu. Sve što unesete, uključujući prekide linija, dio je korisnog tereta. Kada završite, završite s prekidom linije ("\n") i zasebnim retkom koji sadrži samo razdoblje nakon čega slijedi prekid linije (". \ n"). Sada se naredba izvršava, a podaci se šalju poslužitelju.
Primjeri
Tijelo poruke je JSON u oba ova primjera. To može biti bilo koji format, ovisno o očekivanom formatu usluge koja prima poruke.
Primjer 1: Upravljanje IoT uređajem pomoću HTTP posta
Evo makro funkcije koja uključuje svjetlo koje je spojeno na Philips Hue Bridge:
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); }
Isto možete učiniti u naredbenom retku pomoću API-ja:
xcommand HttpClient Put Header: "Content-Type: application/json" URL: "http://192.0.2.10/api/'ZXlU4tUtQ23Pjbdyl-kiyCjTs0i5ANDEu1ypJq0-/lights/1/state" {"on":true} .
Primjer 2: Objavljivanje podataka u alat za praćenje pomoću HTTP posta
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"} .
Dodatne informacije
Više detalja o korištenju zahtjeva HTTP klijenta potražite u V odiču za prilagodbu . Odaberite najnoviju verziju.
Ciscova podrška (TAC) ne podržava uklanjanje pogrešaka koda treće strane, uključujući makronaredbe. Molimo provjerite https://roomos.cisco.com ako vam je potrebna pomoć s makronaredbi i kodom treće strane.
