Présentation : Webhooks clients pour PhotoRobot Cloud

Webhooks clients pour PhotoRobot Cloud

Vos développeurs et équipes informatiques peuvent désormais connecter PhotoRobot Cloud à votre DAM, PIM, ERP ou automatisation personnalisée grâce à des webhooks sortants signés. Les webhooks clients dans PhotoRobot Cloud offrent une livraison de données fiable et événementielle – garantissant une connectivité complète entre votre studio et vos systèmes.

‍

‍

‍

Fermez la boucle entre votre studio et vos systèmes

Assurez-vous que vos systèmes en aval sachent quand le statut d’un élément change ou lorsqu’un événement de disponibilité d’hébergement se produit. PhotoRobot Cloud Customer Webhooks livrent chaque événement à vos points de terminaison afin que les intégrations restent axées sur les événements – et non basées sur des sondages.

Les événements en direct sont :

• item.status.changed – Changement de capture d’état sur un seul objet.
• item.status.bulk_changed — un événement après un changement de statut Cloud Bulk.
• hosting.item.availability.changed — les médias hébergés sont devenus téléchargeables ou indisponibles.
• webhook.subscription.test — Envoyer test uniquement.

‍

‍

‍

Livraison fiable et basée sur les événements

Les Webhooks clients dans PhotoRobot Cloud incluent des fonctionnalités pour :

• Abonnements webhook sortants gérés en parallèle de vos intégrations développeurs.
• Livraison HTTP signée pour que les destinataires puissent vérifier l’authenticité.
• « Envoyer le test » et des filtres pour confirmer l’abonnement au webhook et la vérification de signature.
• Journal de livraison pour inspecter la charge utile, le statut HTTP et les retentions.
• Interface développeur sous Webhooks — Webhooks et livraisons sont disponibles à côté des clés API.

‍

‍

‍

Parler votre langue pour les intégrations de production

Les Webhooks clients sont le chaînon manquant entre la capture robotisée et les systèmes d’enregistrement de l’entreprise. Le webhook est un signal signé, ne transportant volontairement que de petites charges utiles. Après 2xx, l’intégration extrait l’élément courant de REST v2 (pull.itemUrl / pull.deltaUrl). Les Webhooks peuvent informer un éditeur ou, après la vérification, faciliter votre équipe pour lancer une purge CDN ou mettre à jour une fiche de marché. PhotoRobot Cloud parle désormais votre langage pour les intégrations de production.

‍

‍

‍

Un signal, puis une traction

Les charges utiles restent volontairement petites. Chaque charge utile nomme l’événement, l’organisation, et (le cas échéant) l’élément, ainsi que pull.itemUrl et pull.deltaUrl. Les charges utiles ne contiennent pas de binaires d’image, d’arbres de dossiers complets, ni d’enregistrement produit complet.

Le modèle que les développeurs doivent mettre en œuvre est le suivant :

1. Recevez le POST et vérifiez X-PhotoRobot-Signature contre le corps brut.
2. Retournez rapidement 2xx — faites l’importation DAM ou la mise à jour du marketplace dans votre propre employé.
3. Déduplique par identifiant d’événement. La livraison est au moins une fois.
4. Récupérez l’état actuel depuis l’hébergement REST v2 en utilisant les URL de tirage.

Cette division est ce qui rend l’intégration fiable. PhotoRobot n’attend pas que votre travail de catalogue soit terminé, et votre système ne traite jamais une notification comme le catalogue.

‍

‍

‍

Exemples courants de webhooks clients en usage

Les cas d’utilisation les plus courants des Webhooks clients dans l’écosystème PhotoRobot incluent :

• Actualisement PIM ou DAM. Abonnez-vous à hosting.item.availability.changed. Lorsque les médias hébergés deviennent téléchargeables, extrayez itemUrl et mettez à jour le produit — spins, images fixes et métadonnées en un seul passage.
• Liste du marché. Filtrez les événements d’hébergement en « Devenu téléchargeable ». Publiez ou mettez à jour l’annonce seulement après que PhotoRobot ait effectivement diffusé les images.
• Visibilité de la carte de production. Abonnez-vous à item.status.changed lorsque votre conseil ERP ou QC a besoin de savoir qu’un élément a été déplacé vers ÉDITED, APPROVED ou PUBLISHED — même avant que l’hébergement ne soit prêt.
• Mises à jour massives de campagne. Après un important changement de statut dans le Cloud, un événement item.status.bulk_changed arrive avec un deltaUrl. Rattrapez le set concerné au lieu de vous attendre à des milliers de webhooks par article.
• Invalidation du cache ou du CDN. Lorsque l’hébergement passe à disponible ou non disponible, purgez ou réchauffez les chemins que votre boutique connaît déjà. Le webhook est le déclencheur ; L’API d’hébergement est la source des nouvelles URL.

‍

‍

‍

Comment configurer vos webhooks clients

Pour configurer des Webhooks clients pour PhotoRobot Cloud, ouvrez votre PhotoRobot Account en mode Développeurs et utilisez Webhooks pour créer un abonnement webhook. Ensuite, dirigez l’abonnement vers votre point de terminaison de staging pour vérifier la première livraison.

‍

‍

1. Connectez-vous à PhotoRobot Account et ouvrez Développeurs → Webhooks.
2. Créez un webhook. Collez votre point de terminaison HTTPS, donnez-lui un nom interne, et choisissez les événements dont vous avez besoin.
3. Copiez le secret de la signature quand il apparaît — il est montré une fois jusqu’à ce que vous le fassiez tourner.
4. Cliquez sur Envoyer test. Confirmez que webhook.subscription.test arrive et la signature vérifie.
5. Ouvre le journal de livraison pour inspecter la charge utile, le statut HTTP et les tentatives.
6. Pointez le premier abonnement vers un point de départ.

‍

‍

Pour plus d’informations techniques, y compris des exemples de contrats et signatures de développeurs, consultez PhotoRobot Developer Portal – Webhooks.

‍

‍