Ukuthola izaziso ku-Windows kusuka kuzinzwa ze-IoT nge-Webhooks

Xhuma izinzwa IoT y thola izaziso ku-Windows ngaphandle kokuthi uhlale ubuza iseva, lokhu kungenzeka ngenxa yama-webhooks. Empeleni, I-webhook iyi-callback ye-HTTP lokho isevisi ekwenzayo endaweni yakho yokungena lapho kwenzeka umcimbi. Uma ufuna izaziso ezisheshayo, ezithembekile (isibonelo, uma inzwa yezinga lokushisa iqala isaziso ku-PC yakho), le phethini iyona kanye oyidingayo.

Ukuze uyifake endaweni yedeskithophu, into evamile ukuveza indawo yokugcina evikelekile efwini noma kunethiwekhi yakho, uthole isaziso, futhi kusukela lapho. ukusabalalisa ku Windows njengesaziso sesistimu noma uyihlanganise kuhlelo lwakho lokusebenza. Ukusuka lapha sizobona izidingo, izimpendulo ze-HTTP, ukuzama kabusha, ukuqinisekiswa, imijikelezo yokuphila yokubhalisa, izibonelo ezingokoqobo (i-Microsoft Graph, i-Bot Framework, i-FME + Survey123, i-GitHub ene- Apps Iskripthi y -Google Izibalo ezine-Cloud Run) nokuthi ungazixhuma kanjani ukuze izinzwa zakho ze-IoT zigcine zikuxwayisa kudeskithophu yakho ngaphandle kokukhathazeka ngakho.

Iyini i-webhook kanye nezidingo zephoyinti lokugcina?

I-webhook iwuhlelo lwe-HTTP-based callback API. Amasevisi afana ne-Microsoft Graph ayisebenzisela ukukuthumela izaziso uma okuthile kushintsha esisetshenziswa. Ukwenza kahle, Indawo yakho yokungena kufanele ibe sesidlangalaleni futhi ibe ne-HTTPS, ifinyeleleka nge-URL futhi ikwazi ukuphendula ngesikhathi; uma kungenjalo, abahlinzeki bazoyeka ukukuthumela izaziso.

Ngaphezu kokufinyeleleka, indawo yokugcina kufanele ibuye izimpendulo ezilungile nezingashintshi ze-HTTPUma iseva yakho ingaphenduli ngesikhathi, isevisi ingase iqale ukuwisa izaziso. Qaphela: okulahlekile ngale ndlela akukwazi ukuphinda kutholwe, ngakho-ke kuwumqondo omuhle ukuqapha ukubambezeleka nokukala.

Esinye isici esibalulekile ukugunyazwa. Amasevisi amaningi ayathumela noma alindele amathokheni okufinyelela aphelelwe yisikhathi lapho udala noma ugcina ukubhalisa. Uma ithokheni liphelelwa yisikhathi futhi ungalivuseleli, izaziso ngeke zilethwe (yize zingaphinde zizanywe isikhathi esilinganiselwe). Ukulungiselela ukugunyazwa kabusha ngezikhathi ezithile kuyingxenye yomklamo.

Izimpendulo ze-HTTP kanye nokuzama futhi

Abahlinzeki bacabangela isaziso esilethwa lapho bethola ikhodi engu-2xx. Ku-Microsoft Graph, uma isiphetho sibuyisela enye impendulo phakathi nemizuzwana eyi-10, ukuzama futhi kuqaliswa kuze kube amahora angu-4 nge-backoff ye-exponential. Nawu umhlahlandlela osebenzayo:

• I-200 OK lapho ungakwazi ukucubungula isaziso efasiteleni cishe imizuzwana emi-3.
• 202 Kwamukelwe Uma kuzothatha isikhathi eside: faka phakathi isaziso ngaphakathi bese uphendula ngokusamukela.
• 5xx uma ungakwazi ukuyicubungula noma ukuyifaka kulayini, khona-ke isevisi iyakwazi ukuphinda uzame.

Izaziso ezingalethiwe ziphinda zithunyelwe kusetshenziswa iphethini yokubuyisela emuva. Lokhu kusho ukuthi Angathatha amahora angaba ngu-4 ukuze agcwalise. Uma isiphetho sakho senziwe isipele futhi siyasebenza, hlela imigqa nokuphikelela uma uhlelo lwakho lokusebenza ludinga uku-oda komcimbi.

Umkhawulo: Iziphetho ezihamba kancane noma ezingaphenduli

Ukuze kuvikelwe ukusebenza nokuphepha, ezinye izinsiza zilebula izindawo zokugcina ezinokuziphatha okubi. Isibonelo, ku-Microsoft Graph, iphoyinti limakwa njengelihamba kancane uma Izimpendulo ezingaphezu kuka-10% zithatha isikhathi eside kunemizuzwana eyi-10 ngaphakathi kwewindi lemizuzu engu-10; kulesi simo, izaziso ezintsha zithunyelwa kuwe ngokubambezeleka okwengeziwe.

1. Isimo esinensayo: Uma izinga lokuphendula >10 s lidlula u-10% emizuzwini eyi-10, a Ukubambezeleka kwemizuzwana eyi-10 lapho kuthunyelwa izaziso ezintsha. Uphuma kulesi simo uma ubuya ngaphansi kuka-10%.
2. Isimo sokwehlisa: uma lelo phesenti lidlula i- 15% emizuzwini engama-10Izaziso ezintsha zingasuswa kuze kube yimizuzu eyi-10. Izosuswa uma wehla ngaphansi kuka-15%.

Uma isiphetho sakho singahlangabezani nalezi zici zokusebenza, cabanga ukusebenzisa Amahabhu Omcimbi noma Igridi Yomcimbi njengendawo emaphakathi yokumunca ama-spikes nokucubungula ama-decouple.

Ukuphepha: ukuqinisekiswa, ukuphela kwesikhathi kanye ne-firewall

Uma udala ukubhalisa, isevisi ivamise ukuthumela ithokheni yokufinyelela ekugcineni. Leli thokheni lisetshenziselwa ukuqinisekisa ukufaneleka futhi selikwenzile umjikelezo wempilo ngaphandle kokubhalisaUma siphelelwa yisikhathi, izaziso ngeke zisathunyelwa, kodwa lokhu akukhawuli indawo yakho yokugcina. Nokho, isevisi ivamise ukuzama isikhathi esithile (isibonelo, kufika emahoreni angu-4) ngemva kokuphelelwa yisikhathi uma kwenzeka uqinisekisa kabusha ngokuhamba kwesikhathi.

Ukuze ulindele amadethi okuphelelwa yisikhathi, engeza izaziso ze-lifecycle kokubhaliselwe uma kukhona. Ngale ndlela, uzothola izaziso uma ithokheni noma ukubhalisa sekuzophelelwa yisikhathi, futhi ungakuvuselela ngaphandle kokuphazamiseka. Ukuvuselela ukubhalisa kwakho ngokuvamile kubuyekeza ithokheni yakho.

Ngokuqondene namanethiwekhi, ungamisa i-firewall ukuthi ivumele kuphela ukuxhumana okungenayo okuvela kuma-IP athembekile omhlinzeki (isibonelo, amakheli asetshenziswa i-Microsoft Graph). Lokhu kunciphisa indawo yokuhlasela futhi kuvimbela izaziso ezingamanga.

Ukudala okubhaliselwe kanye nokuqinisekisa iphoyinti lokugcina

Iphethini yokubhalisa iyafana kuzo zonke izinkundla. Kugrafu ye-Microsoft, uhlelo lokusebenza lweklayenti lenza THUMELA kokubhaliselwe okubonisa insiza elifuna ukuyiqapha kanye isazisoUrl okumele kuthunyelwe khona izaziso. Uma isicelo sivumelekile, isevisi ithumela ukuqinisekiswa kuleyo URL futhi ilindele impendulo yakho ngesikhathi esifanele.

Ngesikhathi sokuqinisekisa, ithokheni ye-opaque ithunyelwa esicelweni. Isiphetho sakho kufanele phendula ngaphansi kwemizuzwana eyi-10 enombhalo/okucacile okungu-200, Uhlobo Lokuqukethwe, kanye nethokheni yokuqinisekisa emzimbeni (eqoshwe njengombhalo). Uma ungahambisani, ukubhalisa ngeke kudalwe. Kungumkhuba omuhle ukubalekela noma yikuphi okokufaka okubonisayo ukuze uvimbele imijovo: nakuba umhlinzeki engayithumeli i-HTML noma i-JavaScript, iphatha ithokheni njenge-opaque.

Ukubhalisa kuyadingeka clientState (inani eliyimfihlo okuvunyelwene ngalo phakathi kohlelo lwakho lokusebenza kanye nesevisi) elizokuvumela ukuthi uqinisekise ukuthi izaziso ozitholayo zivela kumhlinzeki futhi hhayi enkampanini yangaphandle. Okubhaliselwe ngakunye kunesikhombi sakho, ngisho noma uqapha insiza efanayo nge-URL yesaziso efanayo.

Ukwamukela nokucubungula izaziso

Inqobo nje uma ukubhalisa kusasebenza futhi kunezinguquko, umhlinzeki uthumela OKUTHUNYELWE ku-notificationUrl yakho nemininingwane yomcimbi. Kwesinye isikhathi bakuthumelela amaqoqo ezaziso ngenqwaba eyodwa. thuthukisa ukudilivaNgegrafu ye-Microsoft, izaziso zifaka, kodwa azikhawulelwe ku-ID yesaziso, i-ID yokubhalisa, usuku lokuphelelwa yisikhathi kokubhalisa, i-clientState, uhlobo loshintsho (oludaliwe, olubuyekeziwe, njll.), insiza ethintekile, nedatha yensiza.

Uma uthola isaziso, qinisekisa esokuqala clientStateUma ingafani naleyo oyithumele ngenkathi udala okubhaliselwe, ungakuthathi njengokuvumelekile: kungenzeka ukuthi kwavela ngaphandle komhlinzeki. Ngemva kokuqinisekisa, sebenzisa logic yebhizinisi lakho (buyekeza i-UI, ulayini wezinqubo, izaziso zomlilo zeWindows, njll.).

Umjikelezo wokuphila: ukuvuselela, ukulahlwa, kanye nezaziso zomjikelezo wempilo

Konke okubhaliselwe kuphelelwa yisikhathi noma kuyasuswa. Uma udala eyodwa, uchaza a i-expirationDateTimeNgaleso sikhathi, isevisi isusa ukubhalisa futhi iyeke ukukuthumela izaziso. Okwamanje, isaziso ngasinye ositholayo ngokuvamile sihlanganisa idethi elandelayo yokuphelelwa yisikhathi, okukuvumela ukuthi uhlele ukuvuselela kwakho kusenesikhathi.

Uma ungasazidingi izaziso, ungazidingi Zikhiphe ohlwini nesihlonzi saso; uma konke kuhamba kahle, isevisi ibuyisela i-204 ngaphandle kokuqukethwe. Okuthakazelisa nakakhulu izaziso zomjikelezo wempilo (uma zikhona): ukunikeza a i-lifecycleNotificationUrl Uthola izaziso uma ithokheni yakho yokufinyelela isizophelelwa yisikhathi, uma ukubhalisa kwakho sekuzophela, noma uma umlawuli ehoxisa izimvume zohlelo lwakho lokusebenza.

Ama-Webhooks eziteshini zemiyalezo: Uhlaka lwe-Bot Framework

Eziteshini zemiyalezo ngokwezifiso ezihlanganisa ama-ejenti noma abameleli, imicimbi nemilayezo kuthunyelwa endaweni yokugcina ye-webhook emisiwe. Iphethini evamile isebenzisa okuthi POST ngokumelene ne-a iphuzu lokugcina ngengxoxo yesitayela: {webhook_url}/v3/conversations/{conversationId}/activities.

Ucingo lwenziwa ngesihloko Ukugunyazwa (inkampani yenethiwekhi etholwe ohlelweni lokusebenza olubhalisiwe) futhi inqubomgomo yokuzama futhi iqondile: kufika emizamweni emithathu, ngesikhathi sokulinda samasekhondi angu-10 ngomzamo ngamunye. Ngemva kokuhluleka kathathu, ayisekho imizamo eyenziwayoUma konke kuhamba kahle, iphoyinti lakho lokugcina liphendula ngama-200 futhi umzimba othunyelwe uzitshwa ngenjongo yokuphendula.

I-Payloads ilandela i-schema ye-Bot Framework: izinkambu ezinjengohlobo (umlayezo, umcimbi, noma ukubhala), i-ChannelId, evela (ene-id negama), ingxoxo.id, i-textFormat (isb., ukubeka phansi), nezinanyathiselwa (nokuqukethweType kanye ne-contentUrl) lapho kusebenza. Le modeli ivumela imiyalezo, izinkomba zokubhala kanye nemicimbi yesistimu njengokuhlanganisa/vala.

Ngokuqondene namagama omcimbi, amanani athunyelwa kukhava yenkundla yegama izimo ezifana nalezi I-ejenti Yamukelwe, I-ejenti ivaliwe, IngxoxoIvaliwe, I-AgentStartSecondaryChannel kanye neminye yomjikelezo wokusebenzisana. Uhlu luhlanganisa, phakathi kokuningi, i-PrimaryAgentEndConversation, i-AgentDisconnected, i-AgentRaiseSecondaryChannel, i-AgentEndSecondaryChannel, i-CloseConversation, i-SupervisorForceClosedConversation, i-ConsultAgentInitiated, ConsultAgentFailed, ConsultAgentAcceptSession, ConsultsAcceptSession, ConsultsAgentAgent, ConsultsAgent, ConsultsAgent, ConsultsAgentAgent Xhumana ne-AgentSessionTimedOut, Xhumana ne-AgentRemoved, TransferToAgentInitiated, TransferToAgentFailed, TransferAgentAcceptSession, TransferAgentRejectSession, TransferAgentTimedOutSession, I-AgentEndedConsult, I-AgentJoinedCustomerConversation, I-ConsultantI-ConsultantI-ConsultantI-Consultant, I-ConsultantInferConversation, I-TransferToQueueFailed, Ikhasimende Linqanyuliwe, IKhasimende LinqanyuliweIlindeUmenzeli, I-AgentYabelwe, I-OffOfOperationHoursDueToNonWorkingAmahora kanye OutOfOperationHoursDueToHolidays.

Ukuqaliswa kwesibonelo: Uhlelo lokusebenza lwe-Webhook ku-Cloud Run

Nge-Google Cloud Run, ungakwazi ukusebenzisa isevisi ye-HTTP elalela OKUTHUNYELWE futhi icubungule izaziso ze-webhook. Isibonelo esilula sisebenzisa i-Express idlulisa i-JSON, ifunda unhlokweni, kanye I-X-Goog-Channel-Token futhi ugawula umzimba, ubuyisele 200 uma konke kuhamba kahle. Ngemuva kokuhambisa nge-gcloud run deploy, uthola i-URL yomphakathi yesevisi; lokhu kuzoba i-URI lapho umhlinzeki azokuthumela khona izaziso.

Ekugelezeni kwedatha ye-Google Analytics Data API (v1alpha), lapho udala uhlu lwezethameli ungafaka a i-webhookNotification nge-URI kanye ne-ChannelToken ozikhethela yona ukuze ugweme ukukhwabanisa. Umhlinzeki ulindele i-200 kusuka endaweni yakho yokugcina; uma ithola enye into, ibuyisela iphutha (isibonelo, ingase ibonise ukuthi ibilindele u-200 kodwa ithole u-404). Ngale ndlela, uyazi ukuthi yini okufanele uyilungise. i-URL noma indlela yokuphendula.

Isimo nokuqukethwe kwezaziso ku-Analytics

Isicelo sokuTHUMELA kuwebhu yewebhu sihlanganisa ukumelwa kwe-JSON kwe- ukusebenza isikhathi eside kanye nesitembu seTimestamp (i-epoch Unix (ngamasekhondi amancane). Ungasebenzisa leli fulegi ukuze uthole izaziso eziphindaphindiwe. Lapho udala uhlu lwezethameli, ngokuvamile uthola OKUTHUNYELWE okubili: eyokuqala ngokushesha, enesimo esithi CREATING; eyesibili lapho kuqedwa, enesimo sokuthi OKUSEBENZA noma KWEHLULEKILE ngokufanelekile.

Lokhu kuhanjiswa kufaka phakathi izinkambu ezifana negama (indlela yensiza), izethameli, izethameliDisplayName, ubukhulu, isimo, i-startCreatingTime, amathokheni wesabelo asetshenzisiwe, i-rowCount, iphesenti eliqediwe, kanye ne-webhookNotification block ngokwayo (nge-URI ne-channelToken). Ngalesi sakhiwo, ungakwazi sabela kuseva yakho, rekhoda inqubekelaphambili bese ucupha izenzo ku-Windows kushintsho lokhiye ngalunye.

Ukuzenzakalela nge-GitHub kanye Neskripthi Sezinhlelo Zokusebenza

Elinye icala eliwusizo ukuthola imicimbi ye-GitHub nge-webhook futhi uyiguqule, ngokwesibonelo, ibe i-imeyili ohlwini lokusabalalisa. Ungakwazi ukushicilela a uhlelo lokusebenza lewebhu nge-Google Apps Script (sebenzisa njenge-akhawunti yakho futhi ifinyelelwa yinoma ubani), kopisha i-URL yayo esesidlangalaleni futhi uyilungiselele ku-GitHub kokuthi Izilungiselelo > Ama-Webhooks njenge-URL yokulayisha okukhokhelwayo enohlobo lohlelo lokusebenza/json.

Ngesikhathi sokusetha ku-GitHub ungabona izinketho ezinjengokuthi Ukuqinisekiswa kwe-SSL; kwezinye izimo zokuhlola ivaliwe, nakuba ekukhiqizweni kunconywa ukuyigcina ivuliwe. Uma ukwenza kusebenze sekuqediwe, i-GitHub ithumela imicimbi ku-URL yakho; umbhalo wakho ungawafometha futhi uwadlulisele endaweni (isb., isevisi ye-imeyili). ukuvala umjikelezo isaziso ngekhodi encane kakhulu.

I-Geospatial igeleza ne-Survey123 kanye neseva ye-FME

Ezindaweni ze-GIS, i-webhook eyethulwe ku-Survey123 ingaphakela a indawo yokusebenza kuseva ye-FME ecubungula i-JSON futhi ikhiqize okukhiphayo (isb., i-Excel enamashidi amaningi). Ukwenza lokhu, i-FME Workbench isebenzisa i-Text File Reader enenketho ethi Funda Lilonke kokuthi Kanye kanye ne-JSONFlattener ukuze ihumushe izinkambu ze-JSON zibe izibaluli ze-FME.

Lapho ushicilela indawo yokusebenza kuseva ye-FME, yibhalise okungenani njenge Umhambisi WomsebenziEzicini zayo, nika amandla inketho ethi Thumela I-HTTP Message Body ku-Reader ukuze umzimba we-webhook uthunyelwe ngokuqondile Kufayela Lombhalo Wokufunda lapho inqubo isebenza. Lokhu kuqinisekisa ukuthi okuqukethwe kuhamba kuphelele epayipini lakho.

I-URL ye-webhook ikhiqizwa kusukela kusixhumi esibonakalayo sewebhu Seseva ye-FME (Qalisa Indawo Yokusebenzela > Okuthuthukile). Okokuqala, a Ithokheni Lokhu kucacisa ukufaneleka kwe-webhook. Ebhokisini lengxoxo lokugcina, uzobona i-URL; ukuze uyihlanganise ne-Survey123, ungakhetha Ukugunyazwa Nge-Query String bese uyinamathisele kumapharamitha wocwaningo.

Njengoba konke sekumi ngomumo, ngaso sonke isikhathi lapho umsebenzisi ehambisa inhlolovo, okuqukethwe kuzodluliselwa Kuseva ye-FME, futhi kungene Imisebenzi > Iqediwe Uzokwazi ukuqapha imiphumela. Lesi sakhiwo sihambisana kahle nezinzwa ezishicilela amafomu noma imicimbi, futhi ikuvumela ukuthi uziguqule zibe imibiko noma izexwayiso.

Kusukela ku-webhook kuya kusaziso se-Windows: ibhuloho elisebenzayo

Uma uhlangothi lweseva seluxazululiwe (ukuqinisekisa, ukuphepha, ukuzama kabusha), sekuyisikhathi sokudlulisela isaziso ku-Windows. Umbono ulula: indawo yakho yokugcina yomphakathi ithola umcimbi wezinzwa futhi phusha isignali eqenjini lakhoUngakwenza lokhu ngesevisi emaphakathi eshicilela ebhasini kanye ne-ejenti engasindi ku-Windows ebhalisa futhi ebonisa isaziso.

Uma uphatha ama-spikes, kuwumqondo omuhle ukufaka olayini ngemuva kwakho (isibonelo, uma inqwaba yezaziso ingena) futhi usebenzise ukungabi namandla izihlonzi zomcimbi kanye nesitembu sesikhathi esithunyelweNgale ndlela, uzogwema izimpinda kudeskithophu yakho uma isevisi iphinda izama noma uma umenzeli wakho exhuma kabusha.

I-athikili ehlobene:

Ungavumelanisa kanjani omakhalekhukhwini neWindows ukuze uthole izaziso

Isaka

Umbhali oshisekayo ngomhlaba wamabhayithi nobuchwepheshe ngokujwayelekile. Ngiyathanda ukwabelana ngolwazi lwami ngokubhala, futhi yilokho engizokwenza kule bhulogi, ngikubonise zonke izinto ezithakazelisayo kakhulu ngamagajethi, isofthiwe, ihadiwe, izitayela zobuchwepheshe, nokuningi. Inhloso yami ukukusiza ukuthi uzulazule emhlabeni wedijithali ngendlela elula nejabulisayo.