Webhookak
Webhook batek zure sistema bati abisatzen dio goPrevinan zerbait gertatu bezain laster: gertakari bat erregistratzen da, prestakuntza-saio bat osatzen da edo betetze-eskakizun baten egoera aldatzen da. goPrevinak gertaera adierazten duzun URLra bidaltzen du, HMAC-SHA256 bidez sinatuta X-Webhook-Signature goiburuan.
1. Zer dago pantailan
«Sortu webhook bat» blokea «Izena», «Helburuko URLa» eta bidal daitezkeen «Gertaerak» zerrendarekin: «incident.created» (gertakaria erregistratuta), «training.session.completed» (prestakuntza-saioa osatuta) eta «compliance.status.changed» (betetze-egoeraren aldaketa). Azpian, sortutako webhookak; bat ere ez badago, «Oraindik ez dago webhook-ik.» dio.
2. Webhook bat sortzea
1. Idatzi «Izena» eta «Helburuko URLa» (gertaerak jasoko dituen zure sistemaren HTTPS helbidea).
2. Markatu gutxienez gertaera bat.
3. Sakatu «Sortu webhook bat».
4. Sinadura-gakoa agertzen da “Kopiatu orain sinadura-gako hau; ez da berriro erakutsiko:” abisuarekin. Gorde zure sisteman: harekin egiaztatzen du eskaera bakoitza goPrevinatik datorrela, gorputzaren HMAC-SHA256 kalkulatuz eta X-Webhook-Signature goiburuarekin alderatuz.
3. Bidalketak egiaztatu eta desaktibatu
Zerrendako webhook bakoitzak “Bidalketen historia” (bidalketa bakoitzaren gertaera, egoera, saiakerak, erantzun-kodea eta data), “Aktibatu / desaktibatu” eta “Ezabatu” ditu. Zure URLak 5 aldiz jarraian huts egiten badu, goPrevinak “automatikoki desaktibatuta” markatzen du eta bidaltzeari uzten dio: konpondu zure sistema, begiratu historia eta aktibatu berriro.
4. Zer jasotzen duen zure sistemak
Gertaera bakoitza POST eskaera gisa iristen da, gorputza JSON formatuan eta bi goiburu dituela: X-Webhook-Event, gertaeraren izenarekin, eta X-Webhook-Signature, sinadurarekin. Zure sistemak 2xx kode batekin erantzun behar du; beste edozein erantzun hutsegitetzat hartzen da, berriro saiatzen da eta “Bidalketen historia”n agertzen da.