Λάβετε τα συμβάντα υποδοχής πελατών του Mercateer ως webhooks
Εγγράψτε ένα endpoint στα συμβάντα του Mercateer και λάβετε υπογεγραμμένο payload τη στιγμή που τελειώνει μια κλήση, έρχεται ένας ενδιαφερόμενος πελάτης ή κλείνεται μια δουλειά. Καταχωρίστε και διαχειριστείτε endpoints από το API ή τον πίνακα ελέγχου, και επαληθεύστε κάθε παράδοση με HMAC.
Τι είναι το Webhooks;
Τα webhooks στέλνουν τα συμβάντα υποδοχής πελατών του Mercateer σε ένα URL που ελέγχετε εσείς, σε πραγματικό χρόνο, ώστε τα δικά σας συστήματα να αντιδρούν χωρίς να ρωτούν συνεχώς το API. Κάθε παράδοση είναι ένα payload JSON υπογεγραμμένο με HMAC, καταχωρίζετε και διαχειρίζεστε endpoints από το API ή τον πίνακα ελέγχου, και οι αποτυχημένες παραδόσεις επαναλαμβάνονται με αυξανόμενη καθυστέρηση.
Τι μπορείτε να κάνετε με το Webhooks
Εγκατάσταση σε λίγα λεπτά
Δημιουργήστε ένα endpoint
Καταχωρίστε το URL σας και διαλέξτε τα συμβάντα στα οποία θέλετε να εγγραφείτε, από το API ή από τις Ρυθμίσεις, μετά Προγραμματιστές. Το Mercateer επιστρέφει ένα μυστικό υπογραφής για αυτό το endpoint. Η πρόσβαση στο API περιλαμβάνεται στα πακέτα Crew και Fleet.
Επαληθεύστε την υπογραφή
Σε κάθε παράδοση, διαβάστε τη χρονοσήμανση (t) και την υπογραφή (v1) από την κεφαλίδα υπογραφής, μετά υπολογίστε το HMAC-SHA256 του κειμένου "{timestamp}.{raw request body}" με το μυστικό υπογραφής σας και συγκρίνετέ το με την τιμή v1. Απορρίψτε κάθε αίτημα που δεν ταιριάζει ή του οποίου η χρονοσήμανση είναι παλαιότερη των 5 λεπτών, ώστε να ενεργείτε μόνο σε πρόσφατα payloads που ήρθαν πράγματι από το Mercateer. (Ο βοηθός επαλήθευσης του SDK μας τα κάνει όλα αυτά για εσάς.)
Χειριστείτε τις επαναλήψεις με ασφάλεια
Απαντήστε γρήγορα με 2xx για να επιβεβαιώσετε μια παράδοση. Οι αποτυχημένες παραδόσεις επαναλαμβάνονται με αυξανόμενη καθυστέρηση, οπότε βασίστε τον handler σας στο ID του συμβάντος για να αγνοείτε τα διπλότυπα και να επεξεργάζεστε κάθε συμβάν μία φορά.
Συχνές ερωτήσεις
Συνεργάζεται με όλα σας τα εργαλεία
Το Mercateer μιλά τα ίδια πρωτόκολλα με τα εργαλεία που ήδη χρησιμοποιείτε.
Βάλτε το Mercateer να δουλέψει με το Webhooks
Ξεκινήστε δωρεάν και συνδέστε την υποδοχή πελατών σας σε λίγα λεπτά.
Χωρίς πιστωτική κάρτα