Noutate: Customer Webhooks pentru PhotoRobot Cloud

Customer Webhooks pentru PhotoRobot Cloud

Dezvoltatorii și echipele dumneavoastră IT pot conecta acum PhotoRobot Cloud la sistemul DAM, PIM, ERP sau la automatizările personalizate prin webhook-uri de ieșire semnate. Customer webhooks din PhotoRobot Cloud oferă o livrare fiabilă a datelor, bazată pe evenimente, asigurând conectivitate completă între studioul dumneavoastră și sistemele pe care le utilizați.

‍

‍

‍

Închideți bucla dintre studio și sistemele dumneavoastră

Asigurați-vă că sistemele din aval știu când se schimbă statusul unui articol sau când apare un eveniment de disponibilitate a găzduirii. PhotoRobot Cloud Customer Webhooks livrează fiecare eveniment către endpoint-urile dumneavoastră, astfel încât integrările să rămână bazate pe evenimente, nu pe interogări periodice (polling).

Evenimentele disponibile în prezent sunt:

• item.status.changed – modificare confirmată a statusului de captură pentru un singur articol.
• item.status.bulk_changed — un singur eveniment după o modificare în masă a statusului în Cloud.
• hosting.item.availability.changed — conținutul media găzduit a devenit descărcabil sau indisponibil.
• webhook.subscription.test — doar pentru trimiterea de teste.

‍

‍

‍

Livrare fiabilă a datelor, bazată pe evenimente

Customer Webhooks din PhotoRobot Cloud includ funcții pentru:

• Abonamente la webhook-uri de ieșire, gestionate împreună cu integrările dumneavoastră de dezvoltare.
• Livrare HTTP semnată, astfel încât destinatarii să poată verifica autenticitatea.
• „Send test” și filtre pentru a confirma abonamentul la webhook și verificarea semnăturii.
• Jurnal de livrare pentru inspectarea payload-ului, a statusului HTTP și a reîncercărilor.
• Interfață pentru dezvoltatori, la secțiunea Webhooks — webhook-urile și livrările se găsesc lângă cheile API.

‍

‍

‍

Limbajul dumneavoastră, pentru integrări de producție

Customer Webhooks sunt veriga lipsă între captura robotizată și sistemele de evidență ale companiei. Webhook-ul este un semnal semnat, care transportă intenționat doar payload-uri mici. După un răspuns 2xx, integrarea preia articolul curent din REST v2 (pull.itemUrl / pull.deltaUrl). Webhook-urile pot notifica un publisher sau, după preluare, pot ajuta echipa dumneavoastră să declanșeze o purjare CDN ori să actualizeze o listare pe un marketplace. PhotoRobot Cloud vorbește acum limbajul dumneavoastră pentru integrări de producție.

‍

‍

‍

Un semnal, apoi o preluare

Payload-urile rămân intenționat mici. Fiecare payload indică evenimentul, organizația și (când este relevant) articolul, plus pull.itemUrl și pull.deltaUrl. Payload-urile nu conțin fișiere binare de imagini, structuri complete de foldere sau o fișă completă de produs.

Modelul pe care dezvoltatorii ar trebui să îl implementeze este:

1. Primiți cererea POST și verificați X-PhotoRobot-Signature în raport cu corpul brut al cererii.
2. Returnați rapid 2xx — efectuați importul în DAM sau actualizarea marketplace-ului în propriul worker.
3. Eliminați duplicatele după ID-ul evenimentului. Livrarea se face cel puțin o dată (at-least-once).
4. Preluați starea curentă din găzduirea REST v2, folosind URL-urile de preluare (pull).

Această separare face integrarea fiabilă. PhotoRobot nu așteaptă finalizarea job-ului dumneavoastră de catalog, iar sistemul dumneavoastră nu tratează niciodată o notificare drept catalog.

‍

‍

‍

Exemple frecvente de utilizare a Customer Webhooks

Cele mai frecvente cazuri de utilizare pentru Customer Webhooks în ecosistemul PhotoRobot includ:

• Actualizare PIM sau DAM. Abonați-vă la hosting.item.availability.changed. Când conținutul media găzduit devine descărcabil, preluați itemUrl și actualizați produsul – spin-uri, imagini statice și metadate, într-o singură trecere.
• Listări pe marketplace. Filtrați evenimentele de hosting după „Became downloadable”. Publicați sau actualizați listarea abia după ce PhotoRobot poate livra efectiv imaginile.
• Vizibilitate în fluxul de producție. Abonați-vă la item.status.changed atunci când sistemul dumneavoastră ERP sau tabloul QC trebuie să afle că un articol a trecut în starea EDITED, APPROVED sau PUBLISHED – chiar înainte ca hostingul să fie pregătit.
• Actualizări în masă pentru campanii. După o modificare amplă de status în Cloud, se primește un singur eveniment item.status.bulk_changed împreună cu un deltaUrl. Sincronizați setul afectat, în loc să așteptați mii de webhook-uri individuale, câte unul pentru fiecare articol.
• Invalidarea cache-ului sau a CDN-ului. Când hostingul devine disponibil sau indisponibil, goliți sau preîncălziți căile pe care magazinul dumneavoastră online le cunoaște deja. Webhook-ul este declanșatorul; Hosting API este sursa noilor URL-uri.

‍

‍

‍

Cum să vă configurați Customer Webhooks

Pentru a configura Customer Webhooks pentru PhotoRobot Cloud, deschideți PhotoRobot Account în modul Developers și utilizați Webhooks pentru a crea un abonament la webhook. Apoi, direcționați abonamentul către endpoint-ul dumneavoastră de staging pentru a verifica prima livrare.

‍

‍

1. Autentificați-vă în PhotoRobot Account și deschideți Developers → Webhooks.
2. Creați un webhook. Lipiți endpoint-ul HTTPS, atribuiți-i o denumire internă și selectați evenimentele de care aveți nevoie.
3. Copiați secretul de semnare când apare – este afișat o singură dată, până la rotirea lui.
4. Faceți clic pe Send test. Confirmați că webhook.subscription.test ajunge la destinație și că semnătura este validă.
5. Deschideți Delivery log pentru a inspecta payload-ul, statusul HTTP și reîncercările.
6. Direcționați primul abonament către un endpoint de staging.

‍

‍

Pentru mai multe informații tehnice, inclusiv contractul pentru dezvoltatori și exemple de semnături, consultați PhotoRobot Developer Portal – Webhooks.

‍

‍