Αποστολή γεγονότων στο δικό σας σύστημα με webhooks

Ένα webhook επιτρέπει στο IDup να καλέσει μια διεύθυνση ιστού σας τη στιγμή που συμβαίνει κάτι, για παράδειγμα όταν πληρώνεται ένα τιμολόγιο. Κάθε παράδοση υπογράφεται και επαναλαμβάνεται αν το σύστημά σας δεν απαντήσει.

Προσθέστε ένα endpoint

1. Ανοίξτε το Webhooks καρτέλα και πατήστε Προσθέστε endpoint.
2. Εισάγετε ένα Όνομα και το URL. Πρέπει να είναι δημόσια προσβάσιμο. Διευθύνσεις μέσα σε ιδιωτικό δίκτυο απορρίπτονται για λόγους ασφαλείας.
3. Επιλέξτε το Εκδηλώσεις θέλετε.
4. Προαιρετικά: επιλέξτε ένα Κλειδί API. Το endpoint λαμβάνει μόνο τα γεγονότα που μπορεί να διαβάσει αυτό το κλειδί.
5. Τύπος Αποθήκευση. Το IDup δείχνει Το μυστικό υπογραφής σας μία φορά. Αποθηκεύστε το με ασφάλεια.

Εκδηλώσεις

• Το τιμολόγιο δημιουργήθηκε, Το τιμολόγιο πληρώθηκε, Ληφθείσα πληρωμή
• Νέος πελάτης, Νέα επαφή, Νέος υποψήφιος πελάτης, Νέο εισιτήριο
• Η προσφορά έγινε δεκτή — μια προσφορά που αποδέχθηκε ένας πελάτης

Κάθε παράδοση φέρει τρεις επικεφαλίδες: το όνομα της εκδήλωσης, έναν αριθμό παράδοσης και την υπογραφή. Μια επανάληψη διατηρεί τον ίδιο αριθμό παράδοσης, ώστε το σύστημά σας να μπορεί να αναγνωρίσει τα διπλότυπα.

Ελέγξτε την υπογραφή

Το σύστημά σας πρέπει να υπολογίζει ένα HMAC-SHA256 πάνω στον χρόνο και το ακατέργαστο σώμα με το μυστικό σας, να το συγκρίνει με την υπογραφή και να αρνείται έναν χρόνο παλαιότερο από 5 λεπτά. Πατήστε Επαλήθευση υπογραφής και παραδείγματα για έτοιμο κώδικα.

Δοκιμή, παύση και ανανέωση

• Στείλτε δοκιμή στέλνει ένα δοκιμαστικό γεγονός και δείχνει τον κωδικό HTTP και τον χρόνο που χρειάστηκε.
• Παύση σταματά τις παραδόσεις· Ενεργοποίηση τα ξεκινά ξανά.
• Μυστικό ρολό δημιουργεί ένα νέο μυστικό. Το παλιό σταματά να λειτουργεί αμέσως.
• Διαγραφή αφαιρεί το endpoint. Το αρχείο καταγραφής του διατηρείται.

Επαναλήψεις και το αρχείο καταγραφής

Η διεύθυνσή σας πρέπει να απαντήσει με κωδικό 2xx εντός 5 δευτερολέπτων. Οι ανακατευθύνσεις δεν ακολουθούνται. Αν αποτύχει, το IDup προσπαθεί ξανά μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες και 12 ώρες. Μετά την έκτη προσπάθεια, η παράδοση σημειώνεται Παραίτηση.

Το αρχείο καταγραφής δείχνει κάθε προσπάθεια με γεγονός, τελικό σημείο, προσπάθεια, κωδικό HTTP, διάρκεια και την αρχή της απάντησης. Η κατάσταση είναι Αναμονή, Παραδόθηκε, Απέτυχε ή Παραίτηση. Χρησιμοποιήστε Επαναποστολή για να στείλετε ξανά μια παράδοση.