Introducción: Webhooks para clientes para PhotoRobot Cloud

Webhooks de clientes para PhotoRobot Cloud

Tus desarrolladores y equipos de TI pueden ahora conectar PhotoRobot Cloud a tu DAM, PIM, ERP o automatización personalizada con webhooks salientes firmados. Los webhooks de clientes en PhotoRobot Cloud ofrecen una entrega de datos fiable y orientada a eventos, asegurando conectividad total entre tu estudio y los sistemas.

‍

‍

‍

Cierra el ciclo entre tu estudio y los sistemas

Asegúrate de que tus sistemas posteriores sepan cuándo cambia el estado de un elemento o ocurre un evento de disponibilidad de alojamiento. PhotoRobot Cloud Customer Webhooks entregan cada evento a tus endpoints para que las integraciones sigan siendo basadas en eventos, no basadas en sondeos.

Los eventos en directo son:

• Item.status.changed – Cambio de estado de captura comprometido en un artículo.
• item.status.bulk_changed — un evento después de un cambio de estado en Cloud Bulk.
• hosting.item.availability.changed — Los medios alojados se volvieron descargables o no disponibles.
• webhook.subscription.test — Solo enviar prueba.

‍

‍

‍

Entrega de datos fiable y basada en eventos

Los Webhooks para clientes en PhotoRobot Cloud incluyen funciones para:

• Suscripciones de webhook salientes gestionadas junto con tus integraciones con desarrolladores.
• Entrega HTTP firmada para que los receptores puedan verificar la autenticidad.
• "Enviar prueba" y filtros para confirmar la suscripción y verificación de firma del webhook.
• Registro de entrega para inspeccionar la carga útil, el estado HTTP y las reintentaciones.
• Interfaz de desarrollo bajo Webhooks — Webhooks y entregas están junto a las claves API.

‍

‍

‍

Hablando tu idioma para integraciones de producción

Los Webhooks de los clientes son el eslabón perdido entre la captura robotizada y los sistemas de registro de la empresa. El webhook es una señal firmada, que transporta solo pequeñas cargas útiles a propósito. Tras 2xx, la integración extrae el elemento actual de REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks puede notificar a un editor o, tras la consulta, facilitar a tu equipo para iniciar una purga de CDN o actualizar un listado en el mercado. PhotoRobot Cloud ahora habla tu lenguaje para integraciones de producción.

‍

‍

‍

Una señal, luego un tirón

Las cargas útiles permanecen pequeñas a propósito. Cada carga útil nombra el evento, la organización y (cuando corresponde) el elemento, además de pull.itemUrl y pull.deltaUrl. Las cargas útiles no llevan binarios de imagen, árboles de carpetas completos ni un registro completo del producto.

El patrón que los desarrolladores deben implementar es:

1. Recibe el POST y verifica la firma X-PhotoRobot contra el cuerpo sin filtrar.
2. Devuelve 2xx rápido — haz la importación DAM o la actualización del marketplace en tu propio trabajador.
3. Deduplicar por ID de evento. La entrega es al menos una vez.
4. Obtén el estado actual desde el hosting REST v2 usando las URL de pull.

Esa división es lo que hace que la integración sea fiable. PhotoRobot no espera a que termine tu trabajo de catálogo, y tu sistema nunca trata una notificación como el catálogo.

‍

‍

‍

Ejemplos comunes de webhooks de clientes en uso

Los casos de uso más comunes de los Webhooks de Clientes en el ecosistema PhotoRobot incluyen:

• PIM o actualización DAM. Suscríbete a hosting.item.availability.changed. Cuando los medios alojados se vuelvan descargables, extrae itemUrl y actualiza el producto — giros, imágenes fijas y metadatos en una sola pasada.
• Listado en el mercado. Filtra los eventos de anfitriones a "Se ha vuelto descargable." Publica o actualiza el anuncio solo después de que PhotoRobot pueda mostrar realmente las imágenes.
• Visibilidad de la placa de producción. Suscríbete a item.status.changed cuando tu junta de ERP o control de calidad necesite saber que un elemento ha pasado a EDITADO, APROBADO o PUBLICADO — incluso antes de que el alojamiento esté listo.
• Actualizaciones masivas de campaña. Tras un gran cambio de estado en la nube, llega un evento de item.status.bulk_changed con una deltaURL. Pone al día al conjunto afectado en lugar de esperar miles de webhooks por objeto.
• Invalidación de caché o CDN. Cuando el alojamiento cambia a disponible o no disponible, elimina o calienta los caminos que tu tienda ya conoce. El webhook es el disparador; La API de alojamiento es la fuente de las nuevas URLs.

‍

‍

‍

Cómo configurar los webhooks de tu cliente

Para configurar Customer Webhooks para PhotoRobot Cloud, abre tu cuenta de PhotoRobot en modo Desarrolladores y usa Webhooks para crear una suscripción a Webhook. Luego, apunta la suscripción a tu punto final de staging para verificar la primera entrega.

‍

‍

1. Inicia sesión en PhotoRobot cuenta y abre Developers → Webhooks.
2. Crea un webhook. Pega tu endpoint HTTPS, ponle un nombre interno y elige los eventos que necesitas.
3. Copia el secreto de la firma cuando aparezca — se muestra una vez hasta que lo rotes.
4. Haz clic en Enviar prueba. Confirma que llega webhook.subscription.test y la firma lo verifica.
5. Abre el registro de entregas para inspeccionar la carga útil, el estado HTTP y las reintentaciones.
6. Apunta la primera suscripción a un punto final de staging.

‍

‍

Para más información técnica, incluyendo ejemplos de contratos de desarrollador y firmas, consulte PhotoRobot Developer Portal – Webhooks.

‍

‍