Вступ: Клієнтські веб-хуки для PhotoRobot Cloud

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

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

‍

‍

‍

Замкніть коло між вашою студією та системами

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

Живі події такі:

• item.status.changed – фіксована зміна статусу захоплення на одному елементі.
• item.status.bulk_changed — одна подія після масової зміни статусу Cloud.
• hosting.item.availability.changed — розміщені медіа стали завантажуваними або недоступними.
• webhook.subscription.test — Надсилайте лише тест.

‍

‍

‍

Надійна, подієв-орієнтована доставка даних

Клієнтські вебхуки в PhotoRobot Cloud включають функції для:

• Вихідні веб-підписки керуються разом із вашими інтеграціями з розробниками.
• Підписана HTTP-доставка , щоб отримувачі могли перевірити автентичність.
• «Відправити тест» та фільтри для підтвердження підписки на вебхук і перевірки підпису.
• Журнал доставки для перевірки корисного навантаження, 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 за допомогою URL-адрес для витягування.

Саме це розділення робить інтеграцію надійною. PhotoRobot не чекає, поки ваш каталог завершиться, і ваша система ніколи не розглядає сповіщення як каталог.

‍

‍

‍

Поширені приклади використання клієнтських вебхуків

Найпоширеніші сценарії використання клієнтських вебхуків в екосистемі PhotoRobot включають:

• Оновлення PIM або DAM. Підпишіться на hosting.item.availability.changed. Коли хостовані медіа стануть доступними для завантаження, витягніть itemUrl і оновіть продукт — обертання, статики та метадані за один прохід.
• Оголошення на маркетплейсі. Відфільтруйте події для розміщення до «Стало завантаженим». Публікуйте або оновлюйте оголошення лише після того, як PhotoRobot зможе реально показати зображення.
• Видимість на виробничій платі. Підпишіться на product.status.changed, коли вашій ERP або раді контролю якості потрібно знати, що товар переміщено у EDITED, APPROVE або PUBLISHED — навіть до того, як хостинг буде готовий.
• Масові оновлення кампаній. Після великої зміни статусу в хмарі одна подія item.status.bulk_changed приходить з deltaURL. Наздоганяйте постраждалий набір замість тисяч вебхуків на предмет.
• Інвалідація кешу або CDN. Коли хостинг змінюється на доступний або недоступний, очистите або підігрійте шляхи, які ваш магазин уже знає. Вебхук є тригером; API хостингу є джерелом нових URL.

‍

‍

‍

Як налаштувати вебхуки для клієнтів

Щоб налаштувати Customer Webhooks для PhotoRobot Cloud, відкрийте свій обліковий запис PhotoRobot у режимі розробників і використайте Webhooks для створення підписки на webhook. Потім наведіть підписку на вашу кінцеву точку для підтвердження першої доставки.

‍

‍

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

‍

‍

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

‍

‍