Παρουσιάζουμε τα Customer Webhooks για το PhotoRobot Cloud
Η PhotoRobot παρουσιάζει τα Customer Webhooks για το PhotoRobot Cloud, ώστε να συνδέσετε το DAM, το PIM, το ERP ή τον δικό σας αυτοματισμό με υπογεγραμμένα εξερχόμενα webhooks.
Customer Webhooks για το PhotoRobot Cloud
Οι προγραμματιστές και οι ομάδες πληροφορικής σας μπορούν πλέον να συνδεθούν PhotoRobot Cloud στο DAM, PIM, ERP ή προσαρμοσμένο αυτοματισμό με υπογεγραμμένα εξερχόμενα webhook. Webhook πελατών στο PhotoRobot Cloud προσφέρουν αξιόπιστη παράδοση δεδομένων βάσει συμβάντων – διασφαλίζοντας πλήρη συνδεσιμότητα μεταξύ του στούντιο και των συστημάτων σας.

Κλείστε τον κύκλο μεταξύ του studio και των συστημάτων σας
Φροντίστε ώστε τα συστήματα που λαμβάνουν δεδομένα να ενημερώνονται όταν αλλάζει η κατάσταση ενός αντικειμένου ή όταν προκύπτει συμβάν διαθεσιμότητας φιλοξενίας. Τα Customer Webhooks του PhotoRobot Cloud παραδίδουν κάθε συμβάν στα endpoints σας, έτσι ώστε οι ενσωματώσεις να βασίζονται σε συμβάντα και όχι σε polling.
Τα διαθέσιμα συμβάντα (live) είναι τα εξής:
- item.status.changed – οριστική αλλαγή της κατάστασης λήψης σε ένα αντικείμενο.
- item.status.bulk_changed — ένα συμβάν μετά από μαζική αλλαγή κατάστασης στο Cloud.
- hosting.item.availability.changed — τα φιλοξενούμενα μέσα έγιναν διαθέσιμα για λήψη ή μη διαθέσιμα.
- webhook.subscription.test — μόνο για αποστολή δοκιμής.

Αξιόπιστη παράδοση δεδομένων βάσει συμβάντων
Τα Customer Webhooks στο PhotoRobot Cloud περιλαμβάνουν λειτουργίες για:
- Συνδρομές εξερχόμενων webhooks που διαχειρίζονται μαζί με τις ενσωματώσεις των developers σας.
- Υπογεγραμμένη παράδοση HTTP, ώστε οι παραλήπτες να μπορούν να επαληθεύουν την αυθεντικότητα.
- «Send test» και φίλτρα για την επιβεβαίωση της συνδρομής webhook και της επαλήθευσης υπογραφής.
- Αρχείο καταγραφής παραδόσεων για τον έλεγχο του payload, της κατάστασης HTTP και των επαναληπτικών προσπαθειών.
- Περιβάλλον developer στην ενότητα Webhooks — τα webhooks και οι παραδόσεις βρίσκονται δίπλα στα κλειδιά API.

Η γλώσσα σας για ενσωματώσεις παραγωγής
Τα Customer Webhooks αποτελούν τον κρίκο που έλειπε μεταξύ της ρομποτικής λήψης και των εταιρικών συστημάτων καταγραφής (systems of record). Το webhook είναι ένα υπογεγραμμένο σήμα που σκόπιμα μεταφέρει μόνο μικρά payloads. Μετά την απόκριση 2xx, η ενσωμάτωση ανακτά το τρέχον αντικείμενο από το REST v2 (pull.itemUrl / pull.deltaUrl). Τα webhooks μπορούν να ειδοποιήσουν έναν publisher ή, μετά την ανάκτηση, να διευκολύνουν την ομάδα σας να εκκινήσει CDN purge ή να ενημερώσει μια καταχώριση σε marketplace. Το PhotoRobot Cloud μιλά πλέον τη γλώσσα σας για ενσωματώσεις παραγωγής.

Πρώτα το σήμα, μετά η ανάκτηση
Τα payloads παραμένουν σκόπιμα μικρά. Κάθε payload αναφέρει το συμβάν, τον οργανισμό και (όταν σχετίζεται) το αντικείμενο, καθώς και τα pull.itemUrl και pull.deltaUrl. Τα payloads δεν περιέχουν δυαδικά αρχεία εικόνων, πλήρη δέντρα φακέλων ή πλήρη εγγραφή προϊόντος.
Το μοτίβο που πρέπει να υλοποιήσουν οι developers είναι:
- Λάβετε το POST και επαληθεύστε το X-PhotoRobot-Signature με βάση το ακατέργαστο σώμα του αιτήματος (raw body).
- Επιστρέψτε γρήγορα 2xx — εκτελέστε την εισαγωγή στο DAM ή την ενημέρωση του marketplace στο δικό σας worker.
- Αφαιρέστε τα διπλότυπα με βάση το αναγνωριστικό συμβάντος (event ID). Η παράδοση γίνεται τουλάχιστον μία φορά (at-least-once).
- Ανακτήστε την τρέχουσα κατάσταση από το REST v2 hosting χρησιμοποιώντας τα pull URLs.
Ακριβώς αυτός ο διαχωρισμός καθιστά την ενσωμάτωση αξιόπιστη. Το PhotoRobot δεν περιμένει να ολοκληρωθεί η εργασία καταλόγου σας και το σύστημά σας δεν αντιμετωπίζει ποτέ μια ειδοποίηση ως τον κατάλογο.

Συνηθισμένα παραδείγματα χρήσης των Customer Webhooks
Οι πιο συνηθισμένες περιπτώσεις χρήσης των Customer Webhooks στο οικοσύστημα του PhotoRobot περιλαμβάνουν:
- Ανανέωση PIM ή DAM. Εγγραφείτε στο hosting.item.availability.changed. Όταν το φιλοξενούμενο υλικό γίνεται διαθέσιμο για λήψη, ανακτήστε το itemUrl και ενημερώστε το προϊόν — spins, στατικές εικόνες και μεταδεδομένα με μία κίνηση.
- Καταχώριση σε marketplace. Φιλτράρετε τα συμβάντα hosting στο «Became downloadable». Δημοσιεύστε ή ενημερώστε την καταχώριση μόνο αφού το PhotoRobot μπορεί πράγματι να εξυπηρετήσει τις εικόνες.
- Ορατότητα στον πίνακα παραγωγής. Εγγραφείτε στο item.status.changed όταν το ERP ή ο πίνακας QC σας χρειάζεται να γνωρίζει ότι ένα στοιχείο πέρασε σε κατάσταση EDITED, APPROVED ή PUBLISHED — ακόμη και πριν από την ετοιμότητα του hosting.
- Μαζικές ενημερώσεις καμπανιών. Μετά από μια μεγάλη αλλαγή κατάστασης στο Cloud, λαμβάνετε ένα μόνο συμβάν item.status.bulk_changed με ένα deltaUrl. Συγχρονίστε το σύνολο των επηρεαζόμενων στοιχείων, αντί να αναμένετε χιλιάδες webhooks ανά στοιχείο.
- Ακύρωση cache ή CDN. Όταν το hosting αλλάζει σε διαθέσιμο ή μη διαθέσιμο, καθαρίστε ή προθερμάνετε τις διαδρομές που το κατάστημά σας ήδη γνωρίζει. Το webhook αποτελεί το έναυσμα· το Hosting API είναι η πηγή των νέων URL.

Πώς να διαμορφώσετε τα Customer Webhooks σας
Για να ρυθμίσετε Webhook πελατών για PhotoRobot Cloud, ανοίξτε το δικό σας PhotoRobot Account σε λειτουργία προγραμματιστών και χρησιμοποιήστε Webhooks για να δημιουργήσετε μια συνδρομή webhook. Στη συνέχεια, στρέψτε τη συνδρομή στο τελικό σημείο σταδιοποίησης για να επαληθεύσετε την πρώτη παράδοση.

- Συνδεθείτε στο PhotoRobot Account και ανοίξτε Developers → Webhooks.
- Δημιουργήστε ένα webhook. Επικολλήστε το HTTPS endpoint σας, δώστε του ένα εσωτερικό όνομα και επιλέξτε τα συμβάντα που χρειάζεστε.
- Αντιγράψτε το μυστικό κλειδί υπογραφής όταν εμφανιστεί — εμφανίζεται μία φορά, μέχρι να το αλλάξετε (rotate).
- Κάντε κλικ στο Send test. Επιβεβαιώστε ότι το webhook.subscription.test φτάνει και ότι η υπογραφή επαληθεύεται.
- Ανοίξτε το Delivery log για να ελέγξετε το payload, την κατάσταση HTTP και τις επαναλήψεις.
- Κατευθύνετε την πρώτη συνδρομή σε ένα staging endpoint.

Για περισσότερες τεχνικές πληροφορίες, συμπεριλαμβανομένων του developer contract και παραδειγμάτων υπογραφής, ανατρέξτε στο PhotoRobot Developer Portal – Webhooks.

