Παρουσιάζουμε: Webhook πελατών για PhotoRobot Cloud
PhotoRobot εισάγει Webhook πελατών για PhotoRobot Cloud για να συνδέσετε το DAM, το PIM, το ERP ή τον προσαρμοσμένο αυτοματισμό σας με υπογεγραμμένα εξερχόμενα webhook.
Webhook πελατών για PhotoRobot Cloud
Οι προγραμματιστές και οι ομάδες πληροφορικής σας μπορούν πλέον να συνδεθούν PhotoRobot Cloud στο DAM, PIM, ERP ή προσαρμοσμένο αυτοματισμό με υπογεγραμμένα εξερχόμενα webhook. Webhook πελατών στο PhotoRobot Cloud προσφέρουν αξιόπιστη παράδοση δεδομένων βάσει συμβάντων – διασφαλίζοντας πλήρη συνδεσιμότητα μεταξύ του στούντιο και των συστημάτων σας.
Κλείστε τον κύκλο μεταξύ του στούντιο και των συστημάτων σας
Βεβαιωθείτε ότι τα κατάντη συστήματά σας γνωρίζουν πότε αλλάζει η κατάσταση ενός στοιχείου ή συμβαίνει ένα συμβάν διαθεσιμότητας φιλοξενίας. PhotoRobot Cloud Τα Webhook πελατών παραδίδουν κάθε συμβάν στα τελικά σημεία σας, έτσι ώστε οι ενσωματώσεις να παραμένουν βάσει συμβάντων – όχι βάσει δημοσκοπήσεων.
Οι ζωντανές εκδηλώσεις είναι:
- item.status.changed – δεσμευμένη αλλαγή κατάστασης σύλληψης σε ένα στοιχείο.
- item.status.bulk_changed — ένα συμβάν μετά από μια μαζική αλλαγή κατάστασης στο Cloud.
- hosting.item.availability.changed — Τα φιλοξενούμενα μέσα έγιναν με δυνατότητα λήψης ή μη διαθέσιμα.
- webhook.subscription.test — Αποστολή μόνο δοκιμής.
Αξιόπιστη παράδοση δεδομένων βάσει συμβάντων
Webhook πελατών στο PhotoRobot Cloud περιλαμβάνουν λειτουργίες για:
- Η διαχείριση των εξερχόμενων συνδρομών webhook γίνεται παράλληλα με τις ενσωματώσεις προγραμματιστών σας.
- Υπογεγραμμένη παράδοση HTTP , ώστε οι παραλήπτες να μπορούν να επαληθεύσουν την αυθεντικότητα.
- "Αποστολή δοκιμής" και φίλτρα για επιβεβαίωση της συνδρομής webhook και της επαλήθευσης υπογραφής.
- Αρχείο καταγραφής παράδοσης για επιθεώρηση του φορτίου, της κατάστασης HTTP και των επαναλήψεων.
- Διεπαφή χρήστη προγραμματιστή στα Webhook — webhook και παραδόσεις ζωντανά δίπλα στα κλειδιά API.
Μιλώντας τη γλώσσα σας για ενσωματώσεις παραγωγής
Τα Webhook πελατών είναι ο κρίκος που λείπει μεταξύ της ρομποτικής σύλληψης και των συστημάτων καταγραφής της εταιρείας. Το webhook είναι ένα υπογεγραμμένο σήμα, που μεταφέρει μόνο μικρά ωφέλιμα φορτία επίτηδες. Μετά το 2xx, η ενσωμάτωση αντλεί το τρέχον στοιχείο από το REST v2 (pull.itemUrl / pull.deltaUrl). Τα Webhook μπορούν να ειδοποιήσουν έναν εκδότη ή, μετά το τράβηγμα, να διευκολύνουν την ομάδα σας να ξεκινήσει μια εκκαθάριση CDN ή να ενημερώσει μια καταχώριση στην αγορά. PhotoRobot Cloud μιλά τώρα τη γλώσσα σας για ενσωματώσεις παραγωγής.
Ένα σήμα και μετά ένα τράβηγμα
Τα ωφέλιμα φορτία παραμένουν σκόπιμα μικρά. Κάθε ωφέλιμο φορτίο ονομάζει το γεγονός, τον οργανισμό και (κατά περίπτωση) το στοιχείο, καθώς και pull.itemUrl και pull.deltaUrl. Τα φορτία δεν φέρουν δυαδικά αρχεία εικόνων, πλήρη δέντρα φακέλων ή πλήρη εγγραφή προϊόντος.
Τα μοτίβα που πρέπει να εφαρμόσουν οι προγραμματιστές είναι:
- Λάβετε το POST και επαληθεύστε το X-PhotoRobot-Signature έναντι του ακατέργαστου σώματος.
- Επιστρέψτε 2xx γρήγορα — κάντε την εισαγωγή DAM ή την ενημέρωση της αγοράς στον δικό σας εργαζόμενο.
- Κατάργηση διπλότυπων κατά αναγνωριστικό συμβάντος. Η παράδοση γίνεται τουλάχιστον μία φορά.
- Λάβετε την τρέχουσα κατάσταση από τη φιλοξενία REST v2 χρησιμοποιώντας τις διευθύνσεις URL έλξης.
Αυτός ο διαχωρισμός είναι που κάνει την ενσωμάτωση αξιόπιστη. PhotoRobot δεν περιμένει να ολοκληρωθεί η εργασία του καταλόγου σας και το σύστημά σας δεν αντιμετωπίζει ποτέ μια ειδοποίηση ως κατάλογο.
Συνήθη παραδείγματα Webhook πελατών σε χρήση
Οι πιο συνηθισμένες περιπτώσεις χρήσης για Webhook πελατών στο PhotoRobot οικοσύστημα περιλαμβάνουν:
- Ανανέωση PIM ή DAM. Εγγραφείτε στο hosting.item.availability.changed. Όταν τα φιλοξενούμενα μέσα είναι δυνατή η λήψη, τραβήξτε το itemUrl και ενημερώστε το προϊόν — περιστροφές, φωτογραφίες και μεταδεδομένα με ένα πέρασμα.
- Καταχώριση στο Marketplace. Φιλτράρετε τη φιλοξενία συμβάντων σε "Έγινε δυνατότητα λήψης". Δημοσιεύστε ή ενημερώστε την καταχώριση μόνο αφού το PhotoRobot μπορεί πραγματικά να προβάλει τις εικόνες.
- Ορατότητα πίνακα παραγωγής. Εγγραφείτε στο item.status.changed όταν η πλακέτα ERP ή QC σας πρέπει να γνωρίζει ότι ένα στοιχείο μετακινήθηκε σε ΕΠΕΞΕΡΓΑΣΜΕΝΟ, ΕΓΚΕΚΡΙΜΕΝΟ ή ΔΗΜΟΣΙΕΥΜΕΝΟ — ακόμη και πριν είναι έτοιμη η φιλοξενία.
- Μαζικές ενημερώσεις καμπάνιας. Μετά από μια μεγάλη αλλαγή κατάστασης στο Cloud, ένα συμβάν item.status.bulk_changed φτάνει με ένα deltaUrl. Προλάβετε το επηρεαζόμενο σύνολο αντί να περιμένετε χιλιάδες webhook ανά στοιχείο.
- Ακύρωση προσωρινής μνήμης ή CDN. Όταν η φιλοξενία μετατρέπεται σε διαθέσιμη ή μη διαθέσιμη, καθαρίστε ή ζεστάνετε τις διαδρομές που ήδη γνωρίζει η βιτρίνα σας. Το webhook είναι το έναυσμα. Το API φιλοξενίας είναι η πηγή των νέων διευθύνσεων URL.
Πώς να διαμορφώσετε τα Webhook πελατών σας
Για να ρυθμίσετε Webhook πελατών για PhotoRobot Cloud, ανοίξτε το δικό σας PhotoRobot Account σε λειτουργία προγραμματιστών και χρησιμοποιήστε Webhooks για να δημιουργήσετε μια συνδρομή webhook. Στη συνέχεια, στρέψτε τη συνδρομή στο τελικό σημείο σταδιοποίησης για να επαληθεύσετε την πρώτη παράδοση.
- Συνδεθείτε στον λογαριασμό PhotoRobot και ανοίξτε το Developers → Webhooks.
- Δημιουργήστε ένα webhook. Επικολλήστε το τελικό σημείο HTTPS, δώστε του ένα εσωτερικό όνομα και επιλέξτε τα συμβάντα που χρειάζεστε.
- Αντιγράψτε το μυστικό υπογραφής όταν εμφανιστεί — εμφανίζεται μία φορά μέχρι να το περιστρέψετε.
- Κάντε κλικ στην επιλογή Αποστολή δοκιμής. Επιβεβαιώστε ότι το webhook.subscription.test φτάνει και η υπογραφή επαληθεύεται.
- Ανοίξτε το αρχείο καταγραφής παράδοσης για να επιθεωρήσετε το φορτίο, την κατάσταση HTTP και τις επαναλήψεις.
- Τοποθετήστε την πρώτη συνδρομή σε ένα τελικό σημείο προεργασίας.
Για περισσότερες τεχνικές πληροφορίες, συμπεριλαμβανομένων παραδειγμάτων συμβάσεων προγραμματιστή και υπογραφών, ανατρέξτε στο PhotoRobot Developer Portal – Webhooks.
