Svetainių stebėjimo webhook
Uptimia tikrina jūsų svetaines, sertifikatus ir pirkimo srautus iš už jūsų tinklo ribų, o su kiekvienu patvirtintu incidentu kreipiasi į jūsų galinį tašką. Kas vyksta toliau, sprendžia jūsų pačių kodas — atidaryti užklausą, iš naujo paleisti paslaugą, papildyti skydelį duomenimis — o kiekviena patikra siunčia tą patį formatą, todėl apdorojimo kodą rašote tik kartą.
Authorization: Bearer •••••••••••••••• Content-Type: application/json { "id": 3517, "monitor_type": "uptime", "monitor_name": "Checkout — caldmont.com", "monitor_unique_id": "checkout-prod", "monitor_status": "down", "severity": "critical", "incident_start_time": "2026-07-30T11:47:12+02:00", "incident_end_time": "", "incident_duration_seconds": 0, "message": "*ALERT*: Project Checkout — caldmont.com is DOWN", "monitor_notes": "Failover: drain eu-west-2 first" }
Ne žinutė, o sutartis su kodu
Visi kiti kanalai baigiasi žmogumi, o žmogus supranta ir netvarkingą žinutę. Kodas — ne. Todėl įdomiausia čia niekada nebūna pats turinys, o pristatymo garantijos.
„Kažkas sugedo“ — o kas toliau, spręskite patys
Formuluotė tarp versijų gali keistis, nes žmogus prisitaiko. Bet kai nuo jos ima priklausyti programa, tas laisvumas virsta jūsų integracijos klaida.
Vienuolika laukų, penki pakartojimai, viena struktūra
Vienas objektas visiems patikrų tipams: parašote vieną apdorojimo kodą ir šakojate jį pagal du laukus. Prieš atmesdami kartojame penkis kartus, tad pasikartojimų gali pasitaikyti — apie tai parašyta iš anksto, o ne aptinkama vėliau.
Įspėjimas atkeliauja tiesiai į jūsų kodą
Patikra nepavyksta, ir Uptimia — jau patvirtinusi incidentą — kreipiasi į jūsų galinį tašką su visais duomenimis. Kas vyksta toliau, sprendžia jūsų automatika: čia užklausa atsidaro pati ir užsidaro, kai viskas vėl veikia.
Prijunkite webhook trimis žingsniais
Nereikia nei tvirtinti programos, nei diegti bibliotekos — Uptimia reikia tik URL, į kurį kreiptis, ir, jei galinis taškas apsaugotas, antraštės, kuri praleis vidun.
Įklijuokite savo galinio taško URL
Tuo registracija ir baigiasi — vienas viešas URL.
Pridėkite autentifikavimo antraštes
Neprivaloma — antraštės siunčiamos lygiai taip, kaip jas įrašote, tad žetonas praleis Uptimia pro jūsų pačių duris.
Nukreipkite į jį savo stebėjimo objektus
Pasirinkite patikras, kurios turi jį iškviesti, o bandomasis siuntimas tikruoju formatu įrodys, kad jungtis veikia.
Kaip užregistruoti webhook galinį tašką
Pagalbos centre aprašytas visas įgyvendinimas: kaip pridėti URL, surašyti pasirinktines antraštes, išsiųsti bandomąjį POST ir suprasti, ką sako nepavykęs siuntimas.
Visų tipų patikros. Viena struktūra.
Besibaigiantis sertifikatas, neatsiskaičiusi cron užduotis ir CPU slenkstį viršijęs serveris atkeliauja tuo pačiu plokščiu objektu. Atskiria juos du laukai.
Pokalbių tiltai, duomenų bazės įrašai, automatiniai veiksmai
Kai incidentas tampa objektu, kurį priėmė jūsų kodas, naudingi pritaikymai jau nebeprimena įspėjimų.
Kiti kanalai praneša žmogui.Šis praneša jūsų kodui.
Bandymo metu — visa platforma: visų tipų patikros, 171+ stebėjimo vietų ir kiekvienas patvirtintas incidentas, pristatytas kaip jums priklausantis objektas.
Pristatymo garantijos, surašytos juodu ant balto
Patikimo apdorojimo kodo pagal „atsiųsime jums pranešimą“ neparašysite. Štai tikrosios garantijos.
Bent kartą, su penkiais pakartojimais
Atsakyti turite dešimt sekundžių, o bet koks 2xx laikomas priimtu. Visa kita grįžta į eilę ir kartojama penkis kartus, kaskart pauzė būna minute ilgesnė nei prieš tai, o tada atmetama — todėl pirma atsakykite, o darbą dirbkite po to.
Vienas plokščias objektas, vienuolika raktų
Jokių įdėtinių struktūrų, jokio apgaubiančio objekto, jokios schemos, kuri keistųsi pagal patikros tipą. Du laukai atskiria tipus, o likę devyni niekada nekeičia reikšmės — tarp jų ir monitor_notes, veiksmų plano eilutė, kurią paliko stebėjimo objektą kūręs žmogus.
Įspėjimų audra prideda raktą
Kartu sugedę stebėjimo objektai virsta viena užklausa su papildomu grupės objektu — nariai, skaičiai, perėmimas. Apdorojimo kodas, kuris jo nepaiso, veikia kaip veikęs.
Jūsų antraštės perduodamos toliau
Siunčiame jas pažodžiui, tad tinka ir bearer žetonas, ir bendras slaptas raktas. Turinys nepasirašomas — antraštę tikrinkite savo serveryje, o URL laikykite paslaptyje.
Kur siųsti atsisakysime
Tik viešas http(s); loopback ir privatūs adresų rėžiai atmetami. Adresas nustatomas vieną kartą ir užfiksuojamas, peradresavimų nepaisoma, TLS tikrinamas.
Jokios perėmimo nuorodos — sąmoningai
Kanaluose, kuriuos skaito žmogus, yra pasirašyta nuoroda, sustabdanti eskalavimą prieš kitą pakopą. Mašinos gauna tik faktus — žurnalų srautas, kuris gali nutildyti iškvietimą, anksčiau ar vėliau tai ir padarys.
Kaip veikia stebėjimo webhook'ai
Uptimia tikrina jūsų svetaines iš 171+ išorinių vietų ir, patikrai nepavykus, siunčia HTTP POST su JSON turiniu į bet kurį jūsų užregistruotą URL. Tas pats plokščias objektas atkeliauja po kiekvieno tipo patikros — kuris stebėjimo objektas, kas nutiko, kada ir kiek truko — tad visiems užtenka vieno apdorojimo kodo, o nepavykę siuntimai kartojami.
Klaida, kurią pirmą dieną padaro visi
Atsistatymai, įspėjimai ir bandymai keliauja į tą patį galinį tašką. monitor_status būna down, up arba test; severity — critical arba trouble ir tuščias po atsistatymo. Kodą šakokite pagal abu.
Patvirtinta anksčiau, nei sužino jūsų kodas
Automatika patikima tiek, kiek patikimas ją paleidžiantis signalas. Įspėjimas niekada nesiunčiamas remiantis vienos stebėjimo vietos nuomone — įtartinas gedimas pirma pertikrinamas iš kitų vietų.
Vienuolika laukų kiekviename įvykyje
Kas jame būna visada ir ką kiekvienas laukas reiškia.
Visi įspėjimų kanalai →| Laukas | Pavyzdys | Ką jame rasite |
|---|---|---|
| id | 4172 | Skaitinis stebėjimo objekto id Uptimia sistemoje |
| monitor_type | uptime | Kokio tipo patikra suveikė |
| monitor_name | Dispatch API | Jūsų suteiktas pavadinimas (veikimo patikroms — svetainės pavadinimas) |
| monitor_unique_id | dispatch-api-eu | Jūsų pačių identifikatorius — raktas duomenims sujungti |
| monitor_status | down | down, up arba test |
| severity | critical | critical arba trouble — po atsistatymo tuščias |
| incident_start_time | 2026-07-24T02:17:04+02:00 | ISO 8601, paskyros laiko juosta |
| incident_end_time | 2026-07-24T02:31:07+02:00 | Tuščias, kol incidentas tęsiasi |
| incident_duration_seconds | 843 | Nulis, kol incidentas neužsidaro |
| message | *ALERT*: Project … is DOWN | Vienos eilutės santrauka, kurią gauna kiti kanalai |
| monitor_notes | Failover: drain eu-west-2 first | Stebėjimo objekto pastaba — tuščia, jei niekas jos nerašė |
Dažnai užduodami klausimai apie webhook
01Ką tiksliai siunčia webhook?+
02Kaip autentifikuoti užklausą?+
03Kas nutinka, jei mano galinis taškas lėtas arba neveikia?+
04Ar tas pats įvykis gali ateiti du kartus?+
05Ar galiu nukreipti jį į localhost arba vidinį adresą?+
06Ar sekate peradresavimus?+
07Kas atkeliauja, kai vienu metu sugenda keli stebėjimo objektai?+
08Ar mano apdorojimo kodas gali perimti incidentą ar atsakyti?+
09Ką iš tikrųjų siunčia mygtukas „Send test“?+
10Kiek galinių taškų galiu turėti ir ar tai įskaičiuota?+
Vienas URL, visi patvirtinti incidentai
Užregistruokite galinį tašką, priskirkite jį svarbiausiems stebėjimo objektams — ir kiekvienas patvirtintas gedimas atkeliaus kaip objektas, kurį jūsų sistemos gali įrašyti ir panaudoti.