Webhooks¶
Ažurirano · 3 minuta čitanja
Webhook je adresa u vašem sistemu koju RU4M obaveštava. Kada se promeni neki od vaših događaja ili kompanija, RU4M šalje potpisan zahtev na tu adresu.
Pre nego što počnete¶
Potreban vam je odobren pristup integracijama. Ako ga još nemate, pročitajte Zahtev za pristup integracijama. Ove stranice može da otvori samo Vlasnik ili Admin kompanije.
Možete imati najviše 10 webhookova. Stranica novog webhooka prikazuje koliko ih je u upotrebi, na primer U upotrebi 2 od 10 webhookova.
Adresa mora da počinje sa https://. Vaš sistem mora da prihvati zahtev i proveri njegov potpis tajnom za potpisivanje. Tajna za potpisivanje je lozinka koja dokazuje da zahtev dolazi od RU4M-a.
Ako je RU4M suspendovao vaš pristup, dugme Novi webhook je onemogućeno i RU4M ne šalje isporuke. Pročitajte Pregled, isporuke i evidencija.
Gde se nalazi¶
- Izaberite Integracije u traci sa leve strane.
- Izaberite Webhooks u panelu Integracija.
Webhooks možete otvoriti i direktno. Dugme Novi webhook nalazi se i na stranici Pregled.
Tabela prikazuje za svaki webhook URL, Događaji, Status i datum u koloni Napravljen. Polje Pretraži webhooks… pronalazi webhook po adresi.
Dodavanje webhooka¶
- Izaberite Novi webhook.
- Upišite adresu u polje URL odredišta.
- Po želji upišite Opis.
- Pod Događaji izaberite najmanje jedan događaj.
- Pogledajte Payload koji dobijate da vidite primer podataka koje RU4M šalje.
- Ostavite prekidač na Aktivan da isporuke počnu odmah. Prebacite ga na Pauziran da počnu kasnije.
- Izaberite Napravi webhook.
- Izaberite Kopiraj tajnu.
- Nalepite tajnu u podešavanja svog sistema.
- Označite Ova tajna je sačuvana na sigurnom mestu.
- Izaberite Gotovo.
Stranica Vaša tajna za potpisivanje je spremna prikazuje tajnu samo jednom. Više ne možete da je vidite. Vaš sistem njome proverava potpis svake isporuke.
Novi webhook se pojavljuje u tabeli sa statusom Aktivan ili Pauziran.
Pauziranje i uključivanje webhooka¶
Koristite prekidač u koloni Status.
- Isključite ga da pauzirate webhook. Aplikacija potvrđuje porukom Webhook je pauziran. Dok je pauziran, RU4M ništa ne šalje.
- Uključite ga da isporuke ponovo počnu. Aplikacija potvrđuje porukom Webhook je uključen.
Upravljanje webhookom¶
Otvorite meni akcija na kraju reda webhooka. Nudi četiri akcije.
Izmena webhooka¶
- Izaberite Izmeni.
- Promenite adresu, opis, događaje ili status.
- Izaberite Sačuvaj izmene.
Aplikacija potvrđuje porukom Izmene su sačuvane. Ako napustite stranicu sa nesačuvanim izmenama, aplikacija pita Odbaciti izmene?.
Slanje testa¶
- Izaberite Pošalji test.
- Izaberite Pošalji test u dijalogu Poslati test isporuku?.
RU4M šalje jedan primer događaja na vašu adresu. Aplikacija potvrđuje porukom Test isporuka je poslata. Rezultat proverite na stranici Isporuke.
Rotiranje tajne za potpisivanje¶
Rotirajte tajnu kada ste je izgubili ili mislite da ju je video neko drugi.
- Izaberite Rotiraj tajnu.
- Izaberite Rotiraj tajnu u dijalogu Rotirati tajnu za potpisivanje?.
- Izaberite Kopiraj tajnu na kartici Nova tajna za potpisivanje.
- Označite Ova tajna je sačuvana na sigurnom mestu.
- Izaberite Gotovo.
Stara tajna odmah prestaje da važi. Odmah unesite novu tajnu u svoj sistem.
Tajnu možete rotirati i na stranici za izmenu, na kartici Tajna za potpisivanje.
Brisanje webhooka¶
- Izaberite Obriši.
- Izaberite Obriši webhook u dijalogu Obrisati ovaj webhook?.
Isporuke na tu adresu odmah prestaju. Ovo se ne može poništiti. Aplikacija potvrđuje porukom Webhook je obrisan.
Webhook možete obrisati i na stranici za izmenu, na kartici Obriši webhook.
Kada pristup ponovo bude odobren¶
Kada RU4M opozove pristup, pauzira sve vaše webhooks. Oni prikazuju Pauziran kada je pristup opozvan.
Kada RU4M odobri novi zahtev, webhooks ostaju pauzirani. Stranica za izmenu prikazuje Ovaj webhook je pauziran kada je pristup integracijama opozvan. Ponovo uključite svaki webhook njegovim prekidačem.
Rešavanje problema¶
Vaš sistem ništa ne dobija. Proverite da li je webhook Aktivan i da li je URL odredišta tačan. Zatim otvorite stranicu Isporuke i pogledajte status i odgovor svakog pokušaja.
Izgubili ste tajnu za potpisivanje. RU4M ne može ponovo da je prikaže. Rotirajte tajnu da dobijete novu.
Dugme Novi webhook je onemogućeno. Već imate 10 webhookova ili je RU4M suspendovao vaš pristup. Obrišite webhook koji više ne koristite.
Dugme Rotiraj tajnu je onemogućeno. Na ovoj stranici još čeka novi ključ ili tajna. Prvo izaberite Gotovo na toj kartici.
Aplikacija pita „Napustiti bez čuvanja tajne?“ Napuštate stranicu pre nego što ste kopirali tajnu ili označili polje. Izaberite Ostani i kopirajte tajnu.
Povezani zadaci¶
- Slack — objavljujte novosti u Slack kanalu.
- Pregled, isporuke i evidencija — proverite svaku isporuku i ponovo pošaljite neuspelu.
- API ključevi — omogućite svom sistemu da poziva RU4M API.
- Zahtev za pristup integracijama — dobijte pristup pre dodavanja webhookova.