Un webhook este un mesaj trimis automat de un serviciu către altul, în momentul în care se întâmplă ceva: o comandă nouă, o plată, un formular completat. În loc să întrebi mereu „s-a schimbat ceva?”, primești vestea imediat. Pe LumeaTehnologiei găsiți tehnologia explicată fără jargon, iar aici clarificăm ideea.
Analogia cu soneria
Imaginează-ți că aștepți un colet. Poți ieși la poartă din cinci în cinci minute sau poți lăsa curierul să sune când ajunge. Webhook-ul este soneria: serviciul care are vestea te anunță, iar tu reacționezi doar când este nevoie.
Cum funcționează pas cu pas
- tu îi dai serviciului o adresă web unde vrei să primești anunțurile;
- alegi evenimentele care te interesează, de exemplu o plată reușită;
- când evenimentul apare, serviciul trimite o cerere către adresa ta, cu detalii despre ce s-a întâmplat;
- aplicația ta primește cererea și face ceva: trimite un e-mail, actualizează un stoc, înregistrează o notă;
- răspunde cu un semnal scurt de confirmare, ca serviciul să știe că mesajul a ajuns.
Webhook sau interogare periodică
Varianta clasică este să ceri serviciului, la intervale, dacă a apărut ceva nou. Merge, dar consumă resurse și poate întârzia vestea. Webhook-ul inversează rolul: serviciul te sună când are ceva. Rezultatul este mai rapid și mai economic, mai ales când evenimentele apar rar.
Exemple obișnuite
Un magazin online anunță contabilitatea când o comandă este plătită. Un instrument de proiecte trimite un mesaj în chat când se închide o sarcină. O platformă de plăți îți spune că o încasare a reușit. Toate sunt situații în care un eveniment dintr-un loc trebuie să declanșeze ceva în altul.
Ce poate merge prost
Adresa ta poate fi temporar indisponibilă, iar mesajul se pierde dacă nu e retrimis. Același mesaj poate ajunge de două ori, așa că aplicația trebuie să recunoască repetițiile. Mai e problema securității: oricine ar putea trimite un mesaj fals către adresa ta.
Cum te protejezi
Verifică semnătura sau cheia secretă trimisă de serviciu, folosește o adresă securizată și răspunde rapid. Păstrează un jurnal al mesajelor primite pentru a vedea ce s-a întâmplat dacă ceva nu merge.
O idee din interiorul calculatorului
Principiul „anunță-mă când se întâmplă” apare și în alte locuri. Sistemul de operare, de exemplu, transmite aplicațiilor evenimente precum un clic sau o conexiune nouă, așa cum explică articolul despre ce face sistemul de operare între aplicații și hardware.
Ce conține mesajul primit
De obicei, mesajul este un pachet scurt de date, în format text, care spune ce tip de eveniment a avut loc, când s-a întâmplat și detalii despre obiectul implicat, de exemplu numărul comenzii sau starea plății. Aplicația ta citește aceste informații și hotărăște ce face mai departe. Fiecare serviciu își descrie formatul în documentația proprie.
Pe LumeaTehnologiei găsești și alte explicații despre cum comunică serviciile între ele pe internet, de la cereri simple până la conexiuni securizate.
Recomandare practică
Dacă vrei să încerci, alege un caz simplu, de pildă o notificare când un formular este completat. Folosește o adresă de test, urmărește mesajele primite și abia apoi leagă-l de procese reale. Pentru alte explicații pe înțeles, revino la LumeaTehnologiei, unde ideile tehnice se învață fără grabă.
