Представляем: Клиентские веб-хуки для PhotoRobot Cloud

Клиентские вебхуки для PhotoRobot Cloud

Ваши разработчики и IT-команды теперь могут подключить PhotoRobot Cloud к вашим DAM, PIM, ERP или собственной автоматизации с помощью подписанных исходящих вебхуков. Клиентские вебхуки в PhotoRobot Cloud обеспечивают надёжную, ориентированную на события доставку данных — обеспечивая полную связь между вашей студией и системами.

‍

‍

‍

Закройте круг между вашей студией и системами

Убедитесь, что ваши нижние системы узнают, когда меняется статус товара или происходит событие доступности хостинга. PhotoRobot Cloud Customer Webhooks доставляют каждое событие на ваши конечные устройства, чтобы интеграции оставались ориентированными на события, а не на опросы.

Живые мероприятия включают:

• item.status.changed – фиксированное изменение статуса захвата на одном элементе.
• item.status.bulk_changed — одно событие после массового изменения статуса облака.
• hosting.item.availability.changed — размещённые медиа стали загружаемыми или недоступными.
• webhook.subscription.test — Отправлять только тест.

‍

‍

‍

Надёжная доставка данных, основанная на событиях

Клиентские вебхуки в PhotoRobot Cloud включают функции:

• Исходящие webhook подписки управляются вместе с вашими интеграциями с разработчиками.
• Доставка с подписью HTTP , чтобы получатели могли проверить подлинность.
• «Отправить тест» и фильтры для подтверждения подписки webhook и проверки подписи.
• Журнал доставки для проверки полезной нагрузки, статуса HTTP и повторных попыток.
• Интерфейс разработчика в Webhooks — вебхуки и доставки находятся рядом с API-ключами.

‍

‍

‍

Говорить на своём языке для производственных интеграций

Клиентские вебхуки — это недостающее звено между роботизированным захватом и корпоративными системами записи. Вебхук — это знаковый сигнал, специально несущий только небольшие полезные нагрузки. После 2xx интеграция извлекает текущий элемент из REST v2 (pull.itemUrl / pull.deltaUrl). Вебхуки могут уведомлять издателя или, после запуска, помогать вашей команде запустить очистку CDN или обновить листинг маркетплейса. PhotoRobot Cloud теперь говорит на вашем языке для интеграции в производство.

‍

‍

‍

Потом сигнал, затем притяжение

Полезные нагрузки намеренно остаются небольшими. Каждая полезная нагрузка называет событие, организацию и (при необходимости) элемент, а также pull.itemUrl и pull.deltaURL. Полезные нагрузки не содержат бинарных файлов изображений, полных папочных деревьев или полной записи продукта.

Шаблоны, которые разработчики должны реализовать:

1. Получите POST и проверьте X-PhotoRobot-Signature по исходному телу.
2. Быстро возвращайте 2xx — сделайте импорт DAM или обновление маркетплейса в вашем собственном работнике.
3. Дедупликация по идентификатору события. Доставка происходит как минимум один раз.
4. Получите текущее состояние с хостинга REST v2 с помощью pull URL.

Именно это разделение делает интеграцию надёжной. PhotoRobot не ждёт завершения вашей работы по каталогу, и ваша система никогда не воспринимает уведомление как каталог.

‍

‍

‍

Распространённые примеры используемых клиентских вебхуков

Наиболее распространённые сценарии использования клиентских вебхуков в экосистеме PhotoRobot включают:

• Обновление PIM или DAM. Подпишитесь на hosting.item.availability.changed. Когда размещенные медиафайлы становятся доступны для скачивания, вытащите itemURL и обновите продукт — вращения, статики и метаданные одним проходом.
• Листинг на рынке. Отфильтруйте размещение событий в «Стало загружаемым». Публикуйте или обновляйте объявление только после того, как PhotoRobot сможет действительно показать изображения.
• Видимость производственной платы. Подписывайтесь на productem.status.changed, когда вашей ERP или QC комиссии нужно знать, что элемент перемещён в EDITED, APPROVE или PUBLISHED — даже до того, как хостинг будет готов.
• Массовые обновления кампании. После крупного изменения статуса в облаке появляется одно событие item.status.bulk_changed с deltaURL. Догоняйте затронутый набор, а не ожидайте тысяч вебхуков на каждый предмет.
• Инваляция кэша или CDN. При переключении хостинга на доступный или недоступный, очистите или прогрейте пути, которые ваш магазин уже знает. Вебхук — это триггер; API хостинга — источник новых URL.

‍

‍

‍

Как настроить ваши вебхуки для клиентов

Чтобы настроить Customer Webhooks для PhotoRobot Cloud, откройте свой аккаунт PhotoRobot в режиме Developers и используйте Webhooks для создания подписки на webhook. Затем направьте подписку на вашу конечную точку для подтверждения первой доставки.

‍

‍

1. Войдите в PhotoRobot аккаунт и откройте раздел Developers → Webhooks.
2. Создайте вебхук. Вставьте свой HTTPS-эндпоинт, дайте ему внутреннее имя и выберите нужные события.
3. Скопируйте секрет подписи, когда он появится — он отображается один раз, пока вы не покрутите.
4. Нажмите «Отправить тест». Подтвердите, что webhook.subscription.test пришёл и подпись подтвердилась.
5. Откройте журнал доставки для проверки полезной нагрузки, статуса HTTP и повторных попыток.
6. Направьте первую подписку на конечную точку этапа.

‍

‍

Для получения дополнительной технической информации, включая контракты разработчиков и примеры подписей, обратитесь к порталу разработчиков PhotoRobot – Webhooks.

‍

‍