Presentem els Customer Webhooks per a PhotoRobot Cloud

Customer Webhooks per a PhotoRobot Cloud

Els seus equips de desenvolupament i de TI ja poden connectar PhotoRobot Cloud amb el seu DAM, PIM, ERP o una automatització personalitzada mitjançant webhooks de sortida signats. Els Customer Webhooks de PhotoRobot Cloud ofereixen un lliurament de dades fiable i basat en esdeveniments, que garanteix una connectivitat total entre el seu estudi i els seus sistemes.

‍

‍

‍

Tanqui el cercle entre el seu estudi i els seus sistemes

Asseguri's que els seus sistemes posteriors sàpiguen quan canvia l'estat d'un element o es produeix un esdeveniment de disponibilitat d'allotjament. Els Customer Webhooks de PhotoRobot Cloud lliuren cada esdeveniment als seus endpoints perquè les integracions es basin en esdeveniments, no en consultes periòdiques (polling).

Els esdeveniments disponibles actualment són:

• item.status.changed: canvi d'estat de captura confirmat en un element.
• item.status.bulk_changed: un esdeveniment després d'un canvi d'estat massiu a Cloud.
• hosting.item.availability.changed: un contingut multimèdia allotjat s'ha pogut descarregar o ha deixat d'estar disponible.
• webhook.subscription.test: només en enviar una prova.

‍

‍

‍

Lliurament de dades fiable i basat en esdeveniments

Els Customer Webhooks de PhotoRobot Cloud inclouen funcions per a:

• Subscripcions a webhooks de sortida gestionades juntament amb les seves integracions de desenvolupament.
• Lliurament HTTP signat perquè els receptors puguin verificar-ne l'autenticitat.
• «Send test» i filtres per confirmar la subscripció al webhook i la verificació de la signatura.
• Registre de lliuraments per inspeccionar el payload, l'estat HTTP i els reintents.
• Interfície de desenvolupador a Webhooks: els webhooks i els lliuraments són al costat de les claus d'API.

‍

‍

‍

Parlem el seu idioma en integracions de producció

Els Customer Webhooks són l'enllaç que faltava entre la captura robotitzada i els sistemes de registre de l'empresa. El webhook és un senyal signat que, intencionadament, només porta payloads petits. Després de la resposta 2xx, la integració obté l'element actual de REST v2 (pull.itemUrl / pull.deltaUrl). Els webhooks poden avisar un publicador o, després de l'obtenció de les dades, ajudar el seu equip a iniciar una purga de CDN o a actualitzar una fitxa en un marketplace. PhotoRobot Cloud ja parla el seu idioma en integracions de producció.

‍

‍

‍

Primer un senyal, després l'obtenció de dades

Els payloads es mantenen petits intencionadament. Cada payload indica l'esdeveniment, l'organització i (quan escau) l'element, a més de pull.itemUrl i pull.deltaUrl. Els payloads no inclouen binaris d'imatge, arbres de carpetes complets ni un registre de producte complet.

El patró que haurien d'implementar els desenvolupadors és:

1. Rebre el POST i verificar X-PhotoRobot-Signature respecte al cos sense processar.
2. Retornar 2xx ràpidament: la importació al DAM o l'actualització del marketplace s'han de fer al seu propi worker.
3. Eliminar duplicats per ID d'esdeveniment. El lliurament és com a mínim una vegada (at-least-once).
4. Obtenir l'estat actual de l'allotjament REST v2 mitjançant les URL d'obtenció (pull).

Aquesta separació és el que fa que la integració sigui fiable. PhotoRobot no espera que finalitzi la tasca del seu catàleg, i el seu sistema mai no considera una notificació com si fos el catàleg.

‍

‍

‍

Exemples habituals d'ús dels Customer Webhooks

Els casos d'ús més habituals dels Customer Webhooks a l'ecosistema PhotoRobot inclouen:

• Actualització de PIM o DAM. Subscrigui's a hosting.item.availability.changed. Quan el contingut multimèdia allotjat es pot descarregar, obtingui itemUrl i actualitzi el producte: vistes giratòries (spins), imatges fixes i metadades en un sol pas.
• Publicació en marketplaces. Filtri els esdeveniments d'allotjament per «Became downloadable». Publiqui o actualitzi l'anunci només quan PhotoRobot realment pugui servir les imatges.
• Visibilitat del tauler de producció. Subscrigui's a item.status.changed quan el seu ERP o tauler de control de qualitat (QC) necessiti saber que un element ha passat a EDITED, APPROVED o PUBLISHED, fins i tot abans que l'allotjament estigui llest.
• Actualitzacions massives de campanyes. Després d'un canvi d'estat de gran volum a Cloud, arriba un únic esdeveniment item.status.bulk_changed amb un deltaUrl. Sincronitzi el conjunt afectat en lloc d'esperar milers de webhooks per element.
• Invalidació de la memòria cau o del CDN. Quan l'allotjament passa a disponible o no disponible, purgui o precarregui les rutes que la seva botiga en línia ja coneix. El webhook és l'activador; Hosting API és la font de les noves URL.

‍

‍

‍

Com configurar els seus Customer Webhooks

Per configurar els Customer Webhooks de PhotoRobot Cloud, obri el seu PhotoRobot Account en mode Developers i utilitzi Webhooks per crear una subscripció de webhook. A continuació, dirigeixi la subscripció al seu endpoint de proves (staging) per verificar el primer lliurament.

‍

‍

1. Iniciï la sessió a PhotoRobot Account i obri Developers → Webhooks.
2. Creï un webhook. Enganxi el seu endpoint HTTPS, assigni-li un nom intern i triï els esdeveniments que necessita.
3. Copiï el secret de signatura quan aparegui: es mostra una sola vegada fins que el renovi.
4. Faci clic a Send test. Comprovi que arriba webhook.subscription.test i que la signatura es verifica.
5. Obri Delivery log per inspeccionar la càrrega útil, l'estat HTTP i els reintents.
6. Dirigeixi la primera subscripció a un endpoint de proves (staging).

‍

‍

Per obtenir més informació tècnica, incloent-hi el contracte per a desenvolupadors i exemples de signatura, consulti PhotoRobot Developer Portal – Webhooks.

‍

‍