Presentació: Webhooks per a clients per a PhotoRobot Cloud

Webhooks de clients per a PhotoRobot Cloud

Els teus desenvolupadors i equips de TI ara poden connectar PhotoRobot Cloud al teu DAM, PIM, ERP o automatització personalitzada amb webhooks sortints signats. Els webhooks de clients a PhotoRobot Cloud ofereixen una entrega de dades fiable i basada en esdeveniments, assegurant una connectivitat completa entre el teu estudi i els sistemes.

‍

‍

‍

Tanca el bucle entre l'estudi i els sistemes

Assegura't que els teus sistemes posteriors sàpiguen quan canvia l'estat d'un element o quan es produeix un esdeveniment de disponibilitat d'allotjament. PhotoRobot Cloud Customer Webhooks lliuren cada esdeveniment als teus punts finals perquè les integracions continuïn sent basades en esdeveniments, no basades en enquestes.

Els esdeveniments en directe són:

• Item.status.changed – Canvi d'estat de captura comprès en un article.
• item.status.bulk_changed — un esdeveniment després d'un canvi d'estat de Cloud Bulk.
• hosting.item.availability.changed — Els mitjans allotjats es van tornar descarregables o no disponibles.
• webhook.subscription.test — Només enviar prova.

‍

‍

‍

Lliurament de dades fiable i orientat a esdeveniments

Els webhooks per a clients a PhotoRobot Cloud inclouen funcions per a:

• Les subscripcions sortints de webhooks es gestionen juntament amb les integracions amb desenvolupadors.
• Lliurament HTTP signat perquè els receptors puguin verificar l'autenticitat.
• "Enviar prova" i filtres per confirmar la subscripció i la verificació de signatura del webhook.
• Registre de lliurament per inspeccionar la càrrega útil, l'estat HTTP i les retentacions.
• Interfície de desenvolupador sota Webhooks — webhooks i lliuraments estan al costat de les claus API.

‍

‍

‍

Parlar el teu llenguatge per a integracions de producció

Els webhooks del client són l'enllaç que falta entre la captura robotitzada i els sistemes de registre de l'empresa. El webhook és un senyal signat, que només transporta petites càrregues útils expressament. Després de 2xx, la integració extreu l'element actual de REST v2 (pull.itemUrl / pull.deltaUrl). Els webhooks poden notificar a un editor o, després de la consulta, facilitar que el teu equip iniciï una purga de CDN o actualitzi un llistat al mercat. PhotoRobot Cloud ara parla el teu llenguatge per a integracions de producció.

‍

‍

‍

Un senyal, després una estirada

Les càrregues útils romanen petites expressament. Cada càrrega útil anomena l'esdeveniment, l'organització i (quan rellevant) l'element, a més de pull.itemUrl i pull.deltaUrl. Les càrregues útils no contenen binaris d'imatge, arbres de carpetes complets ni un registre complet del producte.

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

1. Rep el POST i verifica X-PhotoRobot-Signature contra el cos en brut.
2. Retorna 2xx ràpidament — fes la importació DAM o l'actualització del mercat al teu propi treballador.
3. Desduplica per ID d'esdeveniment. El lliurament és almenys una vegada.
4. Recupera l'estat actual de l'allotjament REST v2 utilitzant les URL de tir.

Aquesta divisió és el que fa que la integració sigui fiable. PhotoRobot no espera que acabi la teva feina de catàleg, i el teu sistema mai tracta una notificació com el catàleg.

‍

‍

‍

Exemples comuns de webhooks de clients en ús

Els casos d'ús més comuns dels Webhooks de Client a l'ecosistema PhotoRobot inclouen:

• PIM o DAM refresh. Subscriu-te a hosting.item.availability.changed. Quan el contingut multimèdia allotjat es pugui descarregar, extreu itemUrl i actualitza el producte — girs, imatges fixes i metadades en una sola passada.
• Llistat del Marketplace. Filtra els esdeveniments d'allotjament a "Es pot descarregar." Publica o actualitza la llista només després que PhotoRobot pugui mostrar realment les imatges.
• Visibilitat de la placa de producció. Subscriu-te a item.status.changed quan la teva junta ERP o QC necessiti saber que un element s'ha traslladat a EDITAT, APROVAT o PUBLICAT — fins i tot abans que l'allotjament estigui llest.
• Actualitzacions massives de campanyes. Després d'un gran canvi d'estat al Cloud, arriba un esdeveniment item.status.bulk_changed amb un deltaUrl. Posa't al dia amb el conjunt afectat en comptes d'esperar milers de webhooks per objecte.
• Invalidació de la memòria cau o CDN. Quan l'allotjament canviï a disponible o no disponible, purga o escalfa els camins que la teva botiga ja coneix. El webhook és el desencadenant; L'API d'allotjament és la font de les noves URLs.

‍

‍

‍

Com configurar els webhooks dels teus clients

Per configurar Webhooks de Client per a PhotoRobot Cloud, obre el teu compte de PhotoRobot en mode Desenvolupadors i utilitza Webhooks per crear una subscripció a Webhook. Després, apunta la subscripció al teu punt final de staging per verificar la primera entrega.

‍

‍

1. Inicia sessió al PhotoRobot compte i obre Desenvolupadors → Webhooks.
2. Crea un webhook. Enganxa el teu endpoint HTTPS, posa-li un nom intern i tria els esdeveniments que necessitis.
3. Copia el secret de la signatura quan aparegui — es mostra una vegada fins que el gires.
4. Fes clic a Enviar prova. Confirma que arriba webhook.subscription.test i la signatura ho verifica.
5. Obre el registre de lliurament per inspeccionar la càrrega útil, l'estat HTTP i els intents.
6. Apunta la primera subscripció a un punt final de staging.

‍

‍

Per a més informació tècnica, incloent-hi exemples de contractes de desenvolupador i signatures, consulteu PhotoRobot Developer Portal – Webhooks.

‍

‍