Nowość: Customer Webhooks dla PhotoRobot Cloud
PhotoRobot wprowadza Customer Webhooks dla PhotoRobot Cloud, aby połączyć Państwa system DAM, PIM, ERP lub własną automatyzację za pomocą podpisanych webhooków wychodzących.
Customer Webhooks dla PhotoRobot Cloud
Państwa programiści i zespoły IT mogą teraz połączyć PhotoRobot Cloud z systemem DAM, PIM, ERP lub własną automatyzacją za pomocą podpisanych webhooków wychodzących. Customer Webhooks w PhotoRobot Cloud zapewniają niezawodne, oparte na zdarzeniach dostarczanie danych – a tym samym pełną łączność między Państwa studiem a systemami.
Domknięcie obiegu informacji między studiem a systemami
Dzięki temu Państwa systemy docelowe wiedzą, kiedy zmienia się status elementu lub następuje zdarzenie dotyczące dostępności w hostingu. Customer Webhooks w PhotoRobot Cloud dostarczają każde zdarzenie na Państwa punkty końcowe, dzięki czemu integracje działają w oparciu o zdarzenia, a nie cykliczne odpytywanie (polling).
Dostępne zdarzenia:
- item.status.changed – zatwierdzona zmiana statusu zdjęć dla jednego elementu.
- item.status.bulk_changed — jedno zdarzenie po zbiorczej zmianie statusu w Cloud.
- hosting.item.availability.changed — hostowane media stały się dostępne do pobrania lub przestały być dostępne.
- webhook.subscription.test — wyłącznie dla funkcji „Send test”.
Niezawodne, oparte na zdarzeniach dostarczanie danych
Customer Webhooks w PhotoRobot Cloud obejmują funkcje:
- Subskrypcje webhooków wychodzących zarządzane razem z Państwa integracjami deweloperskimi.
- Podpisane dostarczanie przez HTTP, aby odbiorcy mogli weryfikować autentyczność.
- „Send test” i filtry do potwierdzenia subskrypcji webhooka i weryfikacji podpisu.
- Dziennik dostarczeń do sprawdzania ładunku (payload), statusu HTTP i ponownych prób.
- Interfejs deweloperski w sekcji Webhooks — webhooki i dostarczenia znajdują się obok kluczy API.
Mówimy Państwa językiem w integracjach produkcyjnych
Customer Webhooks to brakujące ogniwo między zrobotyzowanym fotografowaniem a firmowymi systemami referencyjnymi. Webhook to podpisany sygnał, który celowo przenosi jedynie niewielki ładunek. Po odpowiedzi 2xx integracja pobiera aktualny element z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooki mogą powiadomić system publikujący lub – po pobraniu danych – pomóc Państwa zespołowi uruchomić czyszczenie pamięci podręcznej CDN albo zaktualizować ofertę na marketplace. PhotoRobot Cloud mówi teraz Państwa językiem w integracjach produkcyjnych.
Sygnał, a potem pobranie danych
Ładunki celowo pozostają niewielkie. Każdy ładunek wskazuje zdarzenie, organizację i (gdy ma to zastosowanie) element, a także zawiera pull.itemUrl i pull.deltaUrl. Ładunki nie zawierają plików binarnych obrazów, pełnych drzew folderów ani kompletnego rekordu produktu.
Programiści powinni wdrożyć następujący schemat:
- Odebrać żądanie POST i zweryfikować X-PhotoRobot-Signature względem surowej treści żądania.
- Szybko zwrócić odpowiedź 2xx — import do DAM lub aktualizację marketplace wykonać we własnym procesie roboczym (worker).
- Deduplikować według identyfikatora zdarzenia. Dostarczanie działa w modelu „co najmniej raz”.
- Pobrać aktualny stan z hostingu REST v2, korzystając z adresów URL pull.
Właśnie ten podział sprawia, że integracja jest niezawodna. PhotoRobot nie czeka na zakończenie Państwa zadania katalogowego, a Państwa system nigdy nie traktuje powiadomienia jako katalogu.
Typowe przykłady zastosowania Customer Webhooks
Do najczęstszych zastosowań Customer Webhooks w ekosystemie PhotoRobot należą:
- Odświeżanie PIM lub DAM. Należy subskrybować zdarzenie hosting.item.availability.changed. Gdy hostowane materiały staną się dostępne do pobrania, należy pobrać itemUrl i zaktualizować produkt – animacje obrotowe, zdjęcia statyczne i metadane w jednym przebiegu.
- Publikacja ofert na marketplace’ach. Zdarzenia hostingu należy przefiltrować do „Became downloadable”. Ofertę należy publikować lub aktualizować dopiero wtedy, gdy PhotoRobot faktycznie może udostępnić obrazy.
- Podgląd stanu produkcji. Należy subskrybować item.status.changed, gdy Państwa system ERP lub tablica kontroli jakości musi wiedzieć, że element przeszedł do statusu EDITED, APPROVED lub PUBLISHED – jeszcze zanim hosting będzie gotowy.
- Zbiorcze aktualizacje kampanii. Po dużej zmianie statusu w Cloud przychodzi jedno zdarzenie item.status.bulk_changed z deltaUrl. Należy zsynchronizować objęty zmianą zestaw elementów, zamiast oczekiwać tysięcy webhooków dla pojedynczych elementów.
- Unieważnianie pamięci podręcznej lub CDN. Gdy hosting zmienia stan na dostępny lub niedostępny, należy wyczyścić lub rozgrzać ścieżki, które Państwa sklep już zna. Webhook jest wyzwalaczem, a źródłem nowych adresów URL jest Hosting API.
Jak skonfigurować Customer Webhooks
Aby skonfigurować Customer Webhooks dla PhotoRobot Cloud, należy otworzyć PhotoRobot Account w trybie Developers i w sekcji Webhooks utworzyć subskrypcję webhooka. Następnie należy skierować subskrypcję na testowy endpoint (staging), aby zweryfikować pierwszą dostawę.
- Proszę zalogować się do PhotoRobot Account i otworzyć Developers → Webhooks.
- Proszę utworzyć webhook, wkleić adres endpointu HTTPS, nadać mu wewnętrzną nazwę i wybrać potrzebne zdarzenia.
- Proszę skopiować klucz podpisu (signing secret), gdy się pojawi – jest wyświetlany tylko raz, do czasu jego rotacji.
- Proszę kliknąć Send test i potwierdzić, że zdarzenie webhook.subscription.test dotarło, a podpis jest poprawnie weryfikowany.
- Aby sprawdzić payload, status HTTP i ponowione próby, należy otworzyć Delivery log.
- Pierwszą subskrypcję należy skierować na endpoint testowy (staging).
Więcej informacji technicznych, w tym kontrakt dla programistów i przykłady podpisów, znajdą Państwo w PhotoRobot Developer Portal – Webhooks.
