Novità: Customer Webhooks per PhotoRobot Cloud

Customer Webhooks per PhotoRobot Cloud

I Suoi sviluppatori e i team IT possono ora collegare PhotoRobot Cloud al Suo DAM, PIM, ERP o a un'automazione personalizzata tramite webhook in uscita firmati. I Customer Webhooks di PhotoRobot Cloud garantiscono una consegna dei dati affidabile e basata sugli eventi, assicurando la piena connettività tra il Suo studio e i Suoi sistemi.

‍

‍

‍

Chiudere il cerchio tra studio e sistemi

Faccia in modo che i sistemi a valle sappiano quando cambia lo stato di un item o si verifica un evento di disponibilità dell'hosting. I Customer Webhooks di PhotoRobot Cloud consegnano ogni evento ai Suoi endpoint, in modo che le integrazioni restino basate sugli eventi e non sul polling.

Gli eventi attualmente disponibili sono:

• item.status.changed – modifica dello stato di acquisizione confermata su un singolo item.
• item.status.bulk_changed — un evento dopo una modifica collettiva dello stato in Cloud.
• hosting.item.availability.changed — un contenuto multimediale ospitato è diventato scaricabile oppure non disponibile.
• webhook.subscription.test — solo invio di test.

‍

‍

‍

Consegna dei dati affidabile e basata sugli eventi

I Customer Webhooks di PhotoRobot Cloud comprendono funzionalità per:

• Sottoscrizioni a webhook in uscita gestite insieme alle Sue integrazioni per sviluppatori.
• Consegna HTTP firmata, così i destinatari possono verificarne l'autenticità.
• «Send test» e filtri per confermare la sottoscrizione al webhook e la verifica della firma.
• Registro delle consegne per esaminare payload, stato HTTP e nuovi tentativi.
• Interfaccia per sviluppatori in Webhooks — webhook e consegne si trovano accanto alle chiavi API.

‍

‍

‍

Un linguaggio comune per le integrazioni di produzione

I Customer Webhooks sono l'anello mancante tra l'acquisizione robotizzata e i sistemi gestionali aziendali di riferimento. Il webhook è un segnale firmato che, volutamente, trasporta solo payload di piccole dimensioni. Dopo la risposta 2xx, l'integrazione recupera l'item aggiornato da REST v2 (pull.itemUrl / pull.deltaUrl). I webhook possono avvisare un publisher oppure, dopo il pull, aiutare il Suo team ad avviare il purge della CDN o ad aggiornare l'inserzione su un marketplace. PhotoRobot Cloud ora parla la lingua delle integrazioni di produzione.

‍

‍

‍

Prima un segnale, poi un pull

I payload restano volutamente di piccole dimensioni. Ogni payload indica l'evento, l'organizzazione e (se pertinente) l'item, oltre a pull.itemUrl e pull.deltaUrl. I payload non contengono file binari di immagini, strutture complete di cartelle né un record prodotto completo.

Il pattern che gli sviluppatori dovrebbero implementare è il seguente:

1. Ricevere la richiesta POST e verificare X-PhotoRobot-Signature rispetto al body grezzo.
2. Restituire rapidamente 2xx — eseguire l'importazione nel DAM o l'aggiornamento del marketplace nel proprio worker.
3. Deduplicare in base all'ID evento. La consegna è at-least-once.
4. Recuperare lo stato corrente dall'hosting REST v2 tramite gli URL di pull.

È questa separazione a rendere l'integrazione affidabile. PhotoRobot non attende il completamento del Suo job di catalogo e il Suo sistema non considera mai una notifica come il catalogo stesso.

‍

‍

‍

Esempi comuni di utilizzo dei Customer Webhooks

I casi d'uso più comuni dei Customer Webhooks nell'ecosistema PhotoRobot includono:

• Aggiornamento di PIM o DAM. Si iscriva a hosting.item.availability.changed. Quando i contenuti multimediali ospitati diventano scaricabili, recuperi itemUrl e aggiorni il prodotto: spin, still e metadati in un'unica operazione.
• Pubblicazione su marketplace. Filtri gli eventi di hosting su «Became downloadable». Pubblichi o aggiorni l'inserzione solo quando PhotoRobot è effettivamente in grado di servire le immagini.
• Visibilità sullo stato di produzione. Si iscriva a item.status.changed quando il Suo ERP o la Sua dashboard QC deve sapere che un articolo è passato a EDITED, APPROVED o PUBLISHED, anche prima che l'hosting sia pronto.
• Aggiornamenti massivi di campagna. Dopo una modifica di stato su larga scala in Cloud, arriva un unico evento item.status.bulk_changed con un deltaUrl. Si allinei sull'insieme di articoli interessati, invece di attendere migliaia di webhook per singolo articolo.
• Invalidazione di cache o CDN. Quando l'hosting passa a disponibile o non disponibile, svuoti o preriscaldi i percorsi già noti al Suo storefront. Il webhook è il trigger; Hosting API è la fonte dei nuovi URL.

‍

‍

‍

Come configurare i Customer Webhooks

Per configurare i Customer Webhooks per PhotoRobot Cloud, apra il Suo PhotoRobot Account in modalità Developers e utilizzi Webhooks per creare una sottoscrizione webhook. Quindi punti la sottoscrizione al Suo endpoint di staging per verificare la prima consegna.

‍

‍

1. Acceda a PhotoRobot Account e apra Developers → Webhooks.
2. Crei un webhook. Incolli il Suo endpoint HTTPS, gli assegni un nome interno e scelga gli eventi di cui ha bisogno.
3. Copi il signing secret quando compare: viene mostrato una sola volta, finché non lo si rigenera.
4. Faccia clic su Send test. Verifichi che webhook.subscription.test arrivi e che la firma risulti valida.
5. Apra Delivery log per esaminare il payload, lo stato HTTP e i nuovi tentativi.
6. Punti la prima sottoscrizione a un endpoint di staging.

‍

‍

Per ulteriori informazioni tecniche, tra cui il contratto per sviluppatori e gli esempi di firma, consulti PhotoRobot Developer Portal – Webhooks.

‍

‍