Pe langa API, a fost adaugata o facilitate noua: posibilitaatea utilizarii de evenimente de tip webhook.
Utilitatea webhook apare in situatia necesitatii integrarii magazinului dvs eshop-rapid cu terte aplicatii externe. Un webhook, este o actiune (se transmite un mesaj) de tip trigger declasata de un eveniment in site (de exemplu o comanda noua). Aplicatia externa (URL) va primi informatia transmisa via webhook in format JSON (se utlilizeaza HTTP POST).
Evenimentele care pot declansa webhook sunt:
- comanda noua
- utilizator nou inregistrat
- schimbare stare comanda (starile configurate de dvs).
Pentru a defini un webhook, actionati "Creare webhook nou" la admin->Alte servicii->Webhook
Configurati cele 3 valori:
- nume webhook
- evenimetul (exemplu: anulare comanda)
- URL-ul tinta (aplicatia destinatie)
In plus, aveti posibilitatea de a genera/utiliza o cheie de verificare a comunicatiei in campul "Autentificare". Se adauga o semnatura de tip X-Webreal-Signature in header-ul mesajului
Stampila de timp a mesajului este in format ISO 8601 (RFC 339). De exemplu data 09 Iulie, 2019 12:00 (EET) va fi implementata ca 2019-07-09T10:00:00 + 00:00 datorita decalajului de fus orar.
Documentatia in detaliu o gasiti aici: http://helpdesk.webareal.cz/article-base/webareal-webhook-api-dokumentace/
Puteti testa rapid un webhook cu ajutorul unei terte aplicatii open-source. De exemplu https://webhook.site