TABLE OF CONTENTS

Despre webhooks. Ce este un Webhook?

Webhook este o modalitate/metodă de creștere sau modificare a comportamentului unei pagini web sau a unei aplicații web cu apeluri inverse personalizate. Aceste apeluri inverse pot fi întreținute, modificate și gestionate de utilizatori și dezvoltatori terți care nu sunt neapărat asociați cu site-ul web sau aplicația creată. Termenul "webhook" a fost inventat de Jeff Lindsay în 2007. 


Când apare un eveniment, sunt trimise informații către punctul final printr-o cheie API. Datele evenimentului Webhook pot fi stocate ca JSON sau XML.


Utilizările obișnuite ale webhook includ următoarele:

  • Trimitere notificări către clienți pentru acces rapid  
  • Colectarea datelor pentru stocarea datelor  
  • Integrare cu software de contabilitate 
  • Filtrare articolele de comenzi și informare campanii de comenzi 
  • Datele despre clienți sunt eliminate din baza de date 

Adăugare Webhook

1. Accesați panoul de control > Setări > Webhooks > Adaugă webhook

2. Cheie API - De aici alegeți cheia API. Puteți adăuga "Default" (implicit): Acesta este cel pe care l-ați creat automat în magazinul dvs. De asemenea, puteți crea o nouă cheie din meniul Chei API, din setări.
3. Adresa URL de destinație - Aceasta este adresa URL către care va fi direcţionat webhook-ul.
4. Executare/lansare/ la - Aici alegeți acțiunea la care va fi efectuat webhook-ul.


Iată un exemplu I: Dacă există o nouă comandă, acțiunea va executa un weebhook la destinația URL-ului specificat. 
Iată un alt exemplu II: Puteți vedea un exemplu Webhook aici: Order.json

Când primiți un Webhook, vă puteți aștepta la statusuri cu următorul conținut:

  • Statusul comenzii:
    pending, voided, timeouted, cancelled, failed, refunded, paid, complete
  • Statusul plății:
    requested, pending, held, completed, failed, refunded, cancelled, timeouted
  • Statusul expedierii:
    not_fulfilled, fulfilled

Response Code

Există un mecanism care urmărește care va fi response code, returnat de la destinatar.

Dacă response code este 200, totul este în ordine. Însă, dacă response code diferă de 200 sau

dacă întârzie mai mult de 5 secunde cu răspuns, vom repeta până la 5 ori încercările de a livra

informațiile.

Perioadele dintre încercări:

1 - Se trimite în timp real

2 - Se trimite în 60 de secunde după răspunsul anterior

3 - Se trimite în 120 de secunde după răspunsul anterior

4 - Se trimite în 180 de secunde după răspunsul anterior

5 - Se trimite în 240 de secunde după răspunsul anterior

6 - Se trimite în 300 de secunde după răspunsul anterior


După 6 încercări nereușite, dacă informațiile nu sunt primite, nu vor mai fi făcute încercări de

trimitere. Dacă primim response code 400, 401, 403, 404, 405, 406, 410, 411 vom dezactiva

webhook-ul din panoul de administrare al magazinului dvs. Dacă primim în răspuns un text de

tip " please unsubscribe me” atunci acest webhook va fi șters de la administrarea magazinului.