Przedstawiamy: Sieci użytkowników klientów dla PhotoRobot Cloud

Strony Webhooków dla klientów dla PhotoRobot Cloud

Twoi deweloperzy i zespoły IT mogą teraz łączyć PhotoRobot Cloud z twoim DAM, PIM, ERP lub niestandardową automatyzacją za pomocą podpisanych wychodzących webhooków. Webhooki dla klientów w PhotoRobot Cloud oferują niezawodne, zdarzane dostarczanie danych – zapewniając pełną łączność między Twoim studiem a systemami.

‍

‍

‍

Zamknij pętlę między studiem a systemami

Upewnij się, że Twoje systemy w dalszej części wiedzą, kiedy status produktu się zmienia lub pojawia się zdarzenie dostępności hosta. PhotoRobot Cloud Customer Webhooks dostarcza każde zdarzenie do Twoich punktów końcowych, dzięki czemu integracje pozostają oparte na zdarzeniach – a nie na ankietach.

Wydarzenia na żywo to:

• Item.Status.Changed – Zobowiązana zmiana statusu przechwytu na jednym elemencie.
• item.status.bulk_changed — jedno zdarzenie po zmianie statusu masowego w chmurze.
• hosting.item.availability.changed — Hostowane media stały się dostępne lub niedostępne.
• webhook.subscription.test — Tylko wyślij test.

‍

‍

‍

Niezawodne, zdarzane dostarczanie danych

Aplikacje Webhooków dla klientów w PhotoRobot Cloud zawierają funkcje dla:

• Subskrypcje wychodzące webhook zarządzane są równolegle z integracjami deweloperskimi.
• Podpisana dostawa HTTP , aby odbiorcy mogli zweryfikować autentyczność.
• "Wyślij test" i filtry potwierdzające subskrypcję webhooka oraz weryfikację podpisu.
• Dziennik dostawy do inspekcji ładunku, statusu HTTP i powtórzeń.
• Interfejs deweloperski pod Webhookami — webhooki i dostawy są aktywne obok kluczy API.

‍

‍

‍

Mówienie w twoim języku do integracji produkcyjnych

Webhooki klienta to brakujące ogniwo między zrobotyzowanym przechwytywaniem a systemami rejestru firmowego. Webhook to sygnał podpisany, celowo przenoszący tylko małe ładunki. Po 2xx integracja pobiera aktualny element z REST v2 (pull.itemUrl / pull.deltaUrl). Webhooki mogą powiadomić wydawcę lub, po pociągnięciu, ułatwić Twojemu zespołowi rozpoczęcie czystki CDN lub aktualizację oferty na rynku. PhotoRobot Cloud teraz mówi twoim językiem integracji produkcyjnych.

‍

‍

‍

Sygnał, potem pociągnięcie

Ładunki celowo pozostają małe. Każdy ładunek nazywa zdarzenie, organizację oraz (gdy to istotne) przedmiot, plus pull.itemUrl i pull.deltaUrl. Payloady nie zawierają plików binarnych obrazów, pełnych drzew folderów ani pełnego rekordu produktu.

Wzorzec, który powinni wdrożyć twórcy, to:

1. Otrzymaj POST i zweryfikowaj sygnaturę X-PhotoRobot na surowym ciele.
2. Szybko zwróć 2xx — zrób import DAM lub aktualizację marketplace w swoim workerze.
3. Deduplikuj według ID zdarzenia. Dostarczenie odbywa się co najmniej raz.
4. Pobierz aktualny stan z hostingu REST v2, korzystając z pull URL-ów.

To właśnie ten podział sprawia, że integracja jest niezawodna. PhotoRobot nie czeka, aż Twoje zadanie katalogowe się zakończy, a Twój system nigdy nie traktuje powiadomienia jako katalogu.

‍

‍

‍

Typowe przykłady używania webhooków dla klientów

Najczęstsze zastosowania Webhooków dla klienta w ekosystemie PhotoRobot to:

• PIM lub DAM refresh. Subskrybuj hosting.item.availability.changed. Gdy hostowane media staną się dostępne do pobrania, pobierz itemUrl i zaktualizuj produkt — spiny, stills i metadane w jednym przejściu.
• Lista na marketplace. Przefiltruj wydarzenia organizujące wydarzenia do "Stały się dostępne do pobrania". Publikuj lub aktualizuj ogłoszenie dopiero po tym, jak PhotoRobot faktycznie udostępni obrazy.
• Widoczność na tablicy produkcyjnej. Subskrybuj item.status.changed, gdy Twoja rada ERP lub QC musi wiedzieć, że element został przeniesiony do EDYCJI, ZATWIERDZONEJ lub OPUBLIKOWANEJ — nawet zanim hosting będzie gotowy.
• Aktualizacje kampanii masowe. Po dużej zmianie statusu w chmurze pojawia się jedno item.status.bulk_changed wydarzenie z deltaUrl. Nadrobij zaległy zbiór zamiast oczekiwać tysięcy webhooków na każdy element.
• Unieważnienie cache lub CDN. Gdy hosting zmienia się na dostępny lub niedostępny, usuń lub ociep ścieżki, które Twój sklep już zna. Webhook jest wyzwalaczem; API hostingu jest źródłem nowych adresów URL.

‍

‍

‍

Jak skonfigurować webhooki dla klientów

Aby skonfigurować Webhooki dla klientów dla PhotoRobot Cloud, otwórz konto PhotoRobot w trybie Developers i użyj Webhooks do utworzenia subskrypcji webhook. Następnie skieruj subskrypcję na punkt końcowy etapu, aby zweryfikować pierwszą dostawę.

‍

‍

1. Zaloguj się do PhotoRobot konta i otwórz Developers → Webhooks.
2. Stwórz webhook. Wklej swój endpoint HTTPS, nadaj mu wewnętrzną nazwę i wybierz potrzebne zdarzenia.
3. Skopiuj sekret podpisu, gdy się pojawi — jest pokazywany raz, aż go obrócisz.
4. Kliknij Wyślij test. Potwierdź, że webhook.subscription.test dotarł i podpis się zweryfikował.
5. Otwórz dziennik dostarczania , aby sprawdzić ładunek danych, status HTTP i powtórki.
6. Skieruj pierwszą subskrypcję na punkt końcowy stażu.

‍

‍

Więcej informacji technicznych, w tym przykłady umów deweloperskich i podpisów, można znaleźć w PhotoRobot Developer Portal – Webhooks.

‍

‍