介绍:PhotoRobot Cloud 的客户 Webhook

介绍:PhotoRobot Cloud 的客户 Webhook

PhotoRobot 推出了 PhotoRobot Cloud 的客户 Webhooks,将您的 DAM、PIM、ERP 或自定义自动化与签名的出站 Webhook 连接起来。

节省时间并总结此页面的内容
选择您的工具以生成此页面的摘要:

PhotoRobot Cloud 的客户 Webhook

您的开发人员和IT团队现在可以通过签名的出站Webhook将PhotoRobot Cloud连接到您的DAM、PIM、ERP或自定义自动化系统。PhotoRobot Cloud中的客户Webhook提供可靠的事件驱动数据传输——确保您的工作室与系统之间的完全连接。

‍

‍

‍

闭合录音室与系统之间的环路

确保下游系统能及时知道物品状态变化或托管可用性事件发生。PhotoRobot Cloud 客户 Webhook 将每个事件传递到您的终端,确保集成保持事件驱动,而非基于轮询。

现场活动包括:

  • item.status.changed – 对一个项目已提交捕获状态变更。
  • item.status.bulk_changed ——云层批量状态变更后一次事件。
  • hosting.item.availability.changed — 托管媒体变得可下载或不可用。
  • webhook.subscription.test — 仅发送测试。

‍

‍

‍

可靠的事件驱动数据传递

PhotoRobot Cloud 中的客户 Webhook 包括以下功能:

  • 与开发者集成一起管理的外呼Webhook订阅。
  • 签名HTTP传输 ,让接收方验证真实性。
  • “发送测试”以及确认 webhook 订阅和签名验证的过滤器。
  • 通过传输日志 检查载荷、HTTP 状态和重试。
  • Webhooks 下的开发者界面 ——webhook 和交付都实时显示在 API 密钥旁边。

‍

‍

‍

用你的语言进行生产集成

客户Webhook是机器人捕获与公司记录系统之间的缺失环节。webhook是一个签名信号,故意只携带较小的有效载荷。2xx之后,集成会从REST v2中拉取当前项目(pull.itemUrl / pull.deltaUrl)。Webhook可以通知发布者,或在拉取后协助团队启动CDN清理或更新市场列表。PhotoRobot Cloud现在能为生产集成使用你的语言。

‍

‍

‍

一个信号,然后是拉动

有效载荷是故意保持小的。每个载荷都会命名 事件、 组织,以及 (在相关情况下)项目,以及 pull.itemUrl 和 pull.deltaUrl。有效载荷 不 携带图像二进制、完整文件夹树或完整的产品记录。

开发者应实现的模式包括:

  1. 接收POST并验证X-PhotoRobot-Signature与原始本体的匹配。
  2. 快速退回2xx——在你自己的工人中进行DAM导入或市场更新。
  3. 按事件ID进行重复解包。至少一次送达。
  4. 用拉取的URL从REST v2托管获取当前状态。

这种分拆让集成变得可靠。PhotoRobot 不会等你的目录工作完成,系统也从不把通知当作目录。

‍

‍

‍

客户Webhook的常见示例

PhotoRobot生态系统中客户Webhook最常见的用例包括:

  • PIM 或 DAM 刷新。 订阅 hosting.item.availability.changed。当托管媒体可下载时,拉取 itemUrl 并一次性更新产品——旋转、静态和元数据。
  • 市场列表。将举办活动筛选为“已可下载”。只有在 PhotoRobot 能够实际提供图片后,才发布或更新列表。
  • 生产板可视化。 当你的ERP或QC董事会需要知道某个项目被更改为编辑、批准或发布时,订阅item.status.changed——甚至在托管准备就绪之前。
  • 批量活动更新。 在云端发生大幅状态变化后,会有一个item.status.bulk_changed事件带着deltaUrl。赶上受影响的事件集,而不是期待每件物品有成千上万个webhook。
  • 缓存或CDN失效。当托管切换为可用或不可用时,清理或预热你店铺已知的路径。webhook是触发器;托管API是新URL的来源。

‍

‍

‍

如何配置您的客户Webhook

要为 PhotoRobot Cloud 设置客户 Webhooks,请在开发者模式下打开你的 PhotoRobot 账户,使用 Webhooks 创建 webhook 订阅。然后,将订阅指向你的预备终端以验证首次交付。

‍

‍

  1. 登录PhotoRobot账户,→Webhooks打开开发者。
  2. 创建一个 webhook。粘贴你的 HTTPS 端点,给它一个内部名称,然后选择你需要的事件。
  3. 签名秘密出现时复制——它只显示一次,直到你旋转它。
  4. 点击 发送测试。确认webhook.subscription.test到达并验证签名。
  5. 打开 交付日志 以检查有效载荷、HTTP 状态和重试。
  6. 将第一个订阅指向一个临时终端。

‍

‍

如需更多技术信息,包括开发者合同和签名示例,请参阅 PhotoRobot Developer Portal – Webhooks。

‍

‍