Nouveau : Customer Webhooks pour PhotoRobot Cloud

Customer Webhooks pour PhotoRobot Cloud

Vos développeurs et vos équipes IT peuvent désormais connecter PhotoRobot Cloud à votre DAM, votre PIM, votre ERP ou à vos automatisations sur mesure grâce à des webhooks sortants signés. Les Customer Webhooks de PhotoRobot Cloud assurent une transmission des données fiable et pilotée par les événements, pour une connectivité complète entre votre studio et vos systèmes.

‍

‍

‍

Bouclez la boucle entre votre studio et vos systèmes

Informez vos systèmes en aval dès qu’un statut d’article change ou qu’un événement de disponibilité d’hébergement se produit. Les Customer Webhooks de PhotoRobot Cloud transmettent chaque événement à vos endpoints, de sorte que vos intégrations restent pilotées par les événements, et non par du polling.

Les événements actuellement disponibles sont les suivants :

• item.status.changed – changement de statut de capture validé sur un élément.
• item.status.bulk_changed — un événement après un changement de statut groupé dans Cloud.
• hosting.item.availability.changed — un média hébergé est devenu téléchargeable ou indisponible.
• webhook.subscription.test — uniquement pour l’envoi de test.

‍

‍

‍

Une livraison des données fiable et pilotée par les événements

Les Customer Webhooks de PhotoRobot Cloud comprennent des fonctionnalités pour :

• Abonnements aux webhooks sortants gérés avec vos intégrations de développement.
• Livraison HTTP signée pour que les destinataires puissent vérifier l’authenticité.
• « Send test » et filtres pour confirmer l’abonnement au webhook et la vérification de la signature.
• Journal de livraison pour consulter la payload, le statut HTTP et les nouvelles tentatives.
• Interface développeur sous Webhooks — webhooks et livraisons se trouvent à côté des clés API.

‍

‍

‍

Un langage adapté à vos intégrations en production

Les Customer Webhooks sont le chaînon manquant entre la capture robotisée et les systèmes de référence de l’entreprise. Le webhook est un signal signé, qui ne transporte volontairement que de petites charges utiles. Après une réponse 2xx, l’intégration récupère l’article à jour via REST v2 (pull.itemUrl / pull.deltaUrl). Les webhooks peuvent notifier un éditeur ou, après la récupération des données, aider votre équipe à lancer une purge du CDN ou à mettre à jour une fiche sur une place de marché. PhotoRobot Cloud parle désormais votre langage pour les intégrations en production.

‍

‍

‍

D’abord un signal, ensuite une récupération

Les payloads restent volontairement légères. Chaque payload indique l’événement, l’organisation et (le cas échéant) l’élément, ainsi que pull.itemUrl et pull.deltaUrl. Les payloads ne contiennent pas de fichiers image binaires, d’arborescences de dossiers complètes ni de fiche produit complète.

Le schéma que les développeurs doivent mettre en œuvre est le suivant :

1. Recevoir la requête POST et vérifier X-PhotoRobot-Signature par rapport au corps brut.
2. Renvoyer rapidement un code 2xx — effectuer l’import dans le DAM ou la mise à jour sur la place de marché dans votre propre worker.
3. Dédoublonner par ID d’événement. La livraison est de type « at-least-once » (au moins une fois).
4. Récupérer l’état actuel depuis l’hébergement REST v2 à l’aide des URL de récupération.

Cette séparation rend l’intégration fiable. PhotoRobot n’attend pas la fin de votre tâche de catalogue, et votre système ne considère jamais une notification comme le catalogue lui-même.

‍

‍

‍

Exemples courants d’utilisation des Customer Webhooks

Les cas d’usage les plus courants des Customer Webhooks dans l’écosystème PhotoRobot sont les suivants :

• Actualisation du PIM ou du DAM. Abonnez-vous à hosting.item.availability.changed. Lorsque les médias hébergés deviennent téléchargeables, récupérez itemUrl et mettez à jour le produit : spins, photos fixes et métadonnées en une seule passe.
• Publication sur les places de marché. Filtrez les événements d’hébergement sur « Became downloadable ». Publiez ou mettez à jour la fiche uniquement lorsque PhotoRobot est réellement en mesure de servir les images.
• Suivi du tableau de production. Abonnez-vous à item.status.changed lorsque votre ERP ou votre tableau de contrôle qualité doit savoir qu’un élément est passé à l’état EDITED, APPROVED ou PUBLISHED, même avant que l’hébergement ne soit prêt.
• Mises à jour de campagne en masse. Après un changement de statut massif dans Cloud, un seul événement item.status.bulk_changed est envoyé avec un deltaUrl. Rattrapez l’ensemble concerné au lieu d’attendre des milliers de webhooks par élément.
• Invalidation du cache ou du CDN. Lorsque l’hébergement passe à l’état disponible ou indisponible, purgez ou préchargez les chemins déjà connus de votre boutique. Le webhook sert de déclencheur ; Hosting API reste la source des nouvelles URL.

‍

‍

‍

Comment configurer vos Customer Webhooks

Pour configurer les Customer Webhooks de PhotoRobot Cloud, ouvrez votre PhotoRobot Account en mode Developers et utilisez Webhooks pour créer un abonnement webhook. Ensuite, dirigez l’abonnement vers votre endpoint de préproduction afin de vérifier la première transmission.

‍

‍

1. Connectez-vous à PhotoRobot Account et ouvrez Developers → Webhooks.
2. Créez un webhook. Collez votre endpoint HTTPS, donnez-lui un nom interne et sélectionnez les événements dont vous avez besoin.
3. Copiez le secret de signature dès qu’il s’affiche : il n’est visible qu’une seule fois, jusqu’à sa rotation.
4. Cliquez sur Send test. Vérifiez que webhook.subscription.test est bien reçu et que la signature est valide.
5. Ouvrez Delivery log pour examiner la charge utile, le statut HTTP et les nouvelles tentatives.
6. Pointez le premier abonnement vers un endpoint de préproduction.

‍

‍

Pour plus d’informations techniques, notamment le contrat développeur et des exemples de signature, consultez PhotoRobot Developer Portal – Webhooks.

‍

‍