Introduzione: Webhook per clienti per PhotoRobot Cloud

Webhook per clienti per PhotoRobot Cloud

I tuoi sviluppatori e i team IT possono ora collegare PhotoRobot Cloud al tuo DAM, PIM, ERP o automazione personalizzata con webhook outbound firmati. I webhook dei clienti in PhotoRobot Cloud offrono una consegna affidabile e guidata dagli eventi, garantendo completa connettività tra il tuo studio e i sistemi.

‍

‍

‍

Chiudi il ciclo tra il tuo studio e i sistemi

Assicurati che i tuoi sistemi a valle sappiano quando lo stato di un elemento cambia o si verifica un evento di disponibilità di hosting. PhotoRobot Cloud Customer Webhook consegnano ogni evento ai tuoi endpoint, così che le integrazioni rimangano basate su eventi – non basate su sondaggi.

Gli eventi dal vivo sono:

• item.status.changed – Modificato lo stato di cattura su un oggetto.
• item.status.bulk_changed — un evento dopo un cambiamento di stato Cloud Bulk.
• hosting.item.availability.changed — i media ospitati sono diventati scaricabili o non disponibili.
• webhook.subscription.test — Solo invia test.

‍

‍

‍

Consegna affidabile e guidata dagli eventi

I Webhook per i clienti in PhotoRobot Cloud includono funzionalità per:

• Abbonamenti outbound webhook gestiti insieme alle tue integrazioni con sviluppatori.
• Consegna HTTP firmata così i ricevitori possono verificarne l'autenticità.
• "Invia test" e filtri per confermare l'iscrizione al webhook e la verifica della firma.
• Registro di consegna per ispezionare il payload, lo stato HTTP e i tentativi.
• Interfaccia utente per sviluppatori sotto Webhook — webhook e consegne sono presenti accanto alle chiavi API.

‍

‍

‍

Parlare la propria lingua per integrazioni di produzione

I Webhook dei clienti sono l'anello mancante tra la cattura robotizzata e i sistemi di registrazione aziendali. Il webhook è un segnale firmato, che trasporta solo piccoli payload apposta. Dopo 2xx, l'integrazione estrae l'elemento corrente da REST v2 (pull.itemUrl / pull.deltaUrl). Webhook può notificare un editore o, dopo la pull, facilitare il tuo team nell'avviare una purga CDN o nell'aggiornamento di un elenco del marketplace. PhotoRobot Cloud ora parla il tuo linguaggio per le integrazioni di produzione.

‍

‍

‍

Un segnale, poi un richiamo

I payload rimangono piccoli di proposito. Ogni payload nomina l'evento, l'organizzazione e (quando rilevante) l'elemento, più pull.itemUrl e pull.deltaUrl. I payload non contengono binari immagine, alberi di cartelle completi o un record prodotto completo.

Il modello che gli sviluppatori dovrebbero implementare è:

1. Ricevi il POST e verifica X-PhotoRobot-Signature contro il corpo grezzo.
2. Restituisci rapidamente il 2xx — fai l'importazione DAM o l'aggiornamento del marketplace nel tuo operatore.
3. Deduplica per ID evento. La consegna avviene almeno una volta.
4. Recupera lo stato attuale dall'hosting REST v2 usando gli URL di pull.

Questa divisione è ciò che rende l'integrazione affidabile. PhotoRobot non aspetta che il tuo lavoro di catalogo finisca, e il tuo sistema non tratta mai una notifica come il catalogo.

‍

‍

‍

Esempi comuni di webhook per i clienti in uso

I casi d'uso più comuni per i Webhook Clienti nell'ecosistema PhotoRobot includono:

• Aggiornamento PIM o DAM. Iscriviti a hosting.item.availability.changed. Quando i media ospitati diventano scaricabili, estrai itemUrl e aggiorna il prodotto — spin, immagini e metadati in un unico passaggio.
• Elenco del Marketplace. Filtra gli eventi di hosting in "Diventato scaricabile." Pubblica o aggiorna l'annuncio solo dopo che PhotoRobot potrà effettivamente mostrare le immagini.
• Visibilità della scheda di produzione. Iscriviti a item.status.changed quando il tuo consiglio ERP o QC deve sapere che un elemento è stato spostato in EDITED, APPROVED o PUBLISHED — anche prima che l'hosting sia pronto.
• Aggiornamenti della campagna in massa. Dopo un grande cambiamento di stato nel Cloud, arriva un evento item.status.bulk_changed con un deltaUrl. Recupera il set interessato invece di aspettarti migliaia di webhook per singolo oggetto.
• Invalidazione della cache o del CDN. Quando l'hosting passa a disponibile o non disponibile, elimina o riscalda i percorsi che il tuo negozio già conosce. Il webhook è il trigger; L'API di hosting è la fonte dei nuovi URL.

‍

‍

‍

Come configurare i webhook dei tuoi clienti

Per configurare i Webhook dei Clienti per PhotoRobot Cloud, apri il tuo account PhotoRobot in modalità Sviluppatori e usa Webhooks per creare un abbonamento webhook. Poi, indirizza l'abbonamento al tuo endpoint di staging per verificare la prima consegna.

‍

‍

1. Accedi al PhotoRobot Account e apri Developers → Webhooks.
2. Crea un webhook. Incolla il tuo endpoint HTTPS, dagli un nome interno e scegli gli eventi di cui hai bisogno.
3. Copia il segreto della firma quando appare — viene mostrato una volta finché non lo ruoti.
4. Clicca su Invia test. Conferma che webhook.subscription.test arriva e la firma verifica.
5. Apri il Delivery log per ispezionare il payload, lo stato HTTP e i tentativi.
6. Punta il primo abbonamento a un endpoint di staging.

‍

‍

Per ulteriori informazioni tecniche, inclusi esempi di contratti e firme per sviluppatori, consulta PhotoRobot Developer Portal – Webhooks.

‍

‍