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

Клиентски уеб хукове за PhotoRobot Cloud

Вашите разработчици и ИТ екипи вече могат да свържат PhotoRobot Cloud с вашия DAM, PIM, ERP или персонализирана автоматизация чрез подписани изходящи уебхукове. Клиентските уеб хукове в PhotoRobot Cloud предлагат надеждна, събитийно базирана доставка на данни – гарантирайки пълна свързаност между вашето студио и системите.

‍

‍

‍

Затворете връзката между вашето студио и системите

Уверете се, че downstream системите ви знаят кога статусът на даден артикул се променя или настъпва събитие за наличност на хостинга. PhotoRobot Cloud Клиентски Webhooks доставят всяко събитие до вашите крайни точки, така че интеграциите да останат базирани на събития – а не базирани на анкети.

Живите събития са:

• Item.status.changed – Замяна на статуса на заснемане на един елемент.
• item.status.bulk_changed — едно събитие след промяна на статуса на масовия облак.
• hosting.item.availability.changed — хостираните медии станаха достъпни или недостъпни.
• webhook.subscription.test — Изпращайте само тестове.

‍

‍

‍

Надеждна, събитийно-ориентирана доставка на данни

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

• Outbound webhook абонаментите се управляват заедно с вашите интеграции с разработчици.
• Подписана HTTP доставка , за да могат получателите да проверят автентичността.
• "Изпратете тест" и филтри , за да потвърдите абонамента и потвърждаването на подписа на webhook.
• Дневник на доставката за проверка на полезния товар, HTTP статуса и повторните проверки.
• Потребителски интерфейс за разработчици под Webhooks — 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 не чака вашата каталожна задача да приключи, а системата ви никога не третира известие като каталог.

‍

‍

‍

Чести примери за клиентски уебхуки, използвани

Най-честите случаи на употреба на Customer Webhooks в екосистемата на PhotoRobot включват:

• PIM или DAM обновяване. Абонирайте се за hosting.item.availability.changed. Когато хостваната медия стане достъпна за изтегляне, изтеглете itemURL и обновете продукта — завъртания, снимки и метаданни наведнъж.
• Обява на пазара. Филтрирайте събитията за хостване на "Станахме достъпни за изтегляне". Публикувайте или обновете обявата едва след като PhotoRobot може реално да предостави изображенията.
• Видимост на продукционната дъска. Абонирайте се за product.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. Създай webhook. Постави HTTPS крайната точка, дай му вътрешно име и избери събитията, които ти трябват.
3. Копирайте тайната за подписване, когато се появи — показва се веднъж, докато не я завъртите.
4. Кликнете на Изпрати теста. Потвърдете, че webhook.subscription.test пристига и подписът се потвърди.
5. Отворете дневника за доставка , за да проверите полезния товар, HTTP статуса и повторенията.
6. Насочете първия абонамент към крайна точка на етапа.

‍

‍

За повече техническа информация, включително примери за договори с разработчики и подписи, вижте PhotoRobot Developer Portal – Webhooks.

‍

‍