Webhooks
Webhook batek zure sistema bati abisatzen dio goPrevinan zerbait gertatzen denean: istripu bat erregistratzen da, prestakuntza-saio bat amaitzen da edo betetze-eskakizun baten egoera aldatzen da. goPrevinak gertaera adierazten duzun URLra bidaltzen du, HMAC-SHA256rekin sinatuta.
1. Zer dago pantailan
Goian, «Bidalketa bat nola egiaztatu» zabalgarria. Gero, «Sortu webhook bat» blokea «Izena», «Helburuko URLa» eta bidal daitezkeen «Gertaerak» eremuekin («Gertaera guztiak» kutxa eta gertaera bakoitzeko bat, incident.created edo training.session.completed bezala). Azpian, webhook-en zerrenda; bat ere ez badago, “Oraindik ez dago webhook-ik.” dio. Amaieran, «Huts egindako bidalketak».
2. Webhook bat sortzea
1. Idatzi «Izena» eta «Helburuko URLa» (gertaerak jasoko dituen zure sistemaren HTTPS helbidea).
2. Markatu «Gertaera guztiak» edo gutxienez gertaera zehatz bat.
3. Sakatu «Sortu webhook bat».
4. Sinadura-gakoa agertzen da “Kopiatu orain sinadura-gako hau; ez da berriro erakutsiko:” oharrarekin. Gorde zure sisteman eta sakatu “Eginda”: horrekin egiaztatzen duzu eskaera bakoitza goPrevinatik datorrela.
3. Webhook bat zaintzea
Webhook-ak daudenean, zerrendaren gainean hiru egoera-txartel agertzen dira, kopuruarekin: “Bidalketa hutsegindakoekin”, “Desaktibatuak” eta “Intzidentziarik gabe”. Sakatu zerrenda iragazteko. Errenkada bakoitzak izena (bere fitxarako esteka), URLa, gertaerak eta hutsegiteak erakusten ditu, “desaktibatuta” edo “automatikoki desaktibatuta” markarekin bidaltzen ez badu.
Errenkada bakoitzaren eskuinean ikono-botoiak daude: “Bidali proba”, “Bidalketen historia”, “Berriro bidali tartea”, “Aktibatu / desaktibatu” eta “Ezabatu” (berrespena eskatzen du). Sakatu izena webhook-aren fitxa irekitzeko, laburpenarekin eta bidalketa guztiekin.
4. Huts egindako bidalketak eta tarte baten berriro bidaltzea
Zure URLak 5 aldiz jarraian huts egiten badu, goPrevinak webhook-a “automatikoki desaktibatuta” gisa markatzen du eta bidaltzeari uzten dio: konpondu zure sistema eta aktibatu berriro “Aktibatu / desaktibatu”-rekin.
«Huts egindako bidalketak»-ek saiakera guztien ondoren huts egindako bidalketak zerrendatzen ditu, gertaerarekin, webhook-arekin, errorearekin eta datarekin. Zure helmugak berriro funtzionatzen duenean, sakatu errenkadako “Berriro bidali”. Asko aldi berean errepikatzeko, “Berriro bidali tartea”-k “Noiztik” eta “Noiz arte” eskatzen ditu (gehienez 31 egun) eta webhook-a harpidetuta dagoen tarte horretako gertaerak berriro bidaltzen ditu.
5. Zure sistemak zer egin behar duen
Gertaera bakoitza POST eskaera gisa iristen da, gorputza JSON formatuan eta sinadura goiburuan. «Bidalketa bat nola egiaztatu» zabalgarriak sinaduraren kalkulua erakusten du eta bi arau gogorarazten ditu: 5 minutu baino zaharragoa den denbora-zigilua baztertu eta bikoiztuak baztertu, bidalketa bat behin baino gehiagotan irits baitaiteke. Zure sistemak 2xx kodearekin erantzun behar du; beste edozein erantzun hutsegite gisa zenbatzen da, berriro saiatzen da eta bidalketen historian geratzen da.