Представљамо: Customer Webhooks за PhotoRobot Cloud

Customer Webhooks за PhotoRobot Cloud

Ваши програмери и ИТ тимови сада могу да повежу PhotoRobot Cloud са Вашим DAM, PIM, ERP системом или прилагођеном аутоматизацијом помоћу потписаних одлазних webhook-ова. Customer webhooks у систему PhotoRobot Cloud обезбеђују поуздану испоруку података вођену догађајима – за потпуну повезаност између Вашег студија и Ваших система.

‍

‍

‍

Затворите круг између Вашег студија и система

Обезбедите да Ваши низводни системи знају када се промени статус ставке или наступи догађај доступности хостинга. PhotoRobot Cloud Customer Webhooks испоручују сваки догађај на Ваше крајње тачке (endpoints), па интеграције остају вођене догађајима – а не засноване на упитивању (polling).

Активни догађаји су:

• item.status.changed – потврђена промена статуса снимања на једној ставци.
• item.status.bulk_changed — један догађај након групне промене статуса у систему Cloud.
• hosting.item.availability.changed — хостовани медиј је постао доступан за преузимање или више није доступан.
• webhook.subscription.test — само слање теста.

‍

‍

‍

Поуздана испорука података вођена догађајима

Customer Webhooks у систему PhotoRobot Cloud обухватају функције за:

• Претплате на одлазне webhook-ове којима се управља заједно са Вашим интеграцијама за програмере.
• Потписану HTTP испоруку како би примаоци могли да провере аутентичност.
• „Send test“ и филтере за потврду webhook претплате и провере потписа.
• Евиденцију испорука за увид у payload, HTTP статус и поновне покушаје.
• Развојни кориснички интерфејс у одељку Webhooks — webhook-ови и испоруке налазе се поред API кључева.

‍

‍

‍

Говоримо Вашим језиком у продукционим интеграцијама

Customer Webhooks су карика која је недостајала између роботизованог снимања и корпоративних евиденционих система. Webhook је потписан сигнал који намерно носи само мале payload-е. Након одговора 2xx, интеграција преузима актуелну ставку преко REST v2 (pull.itemUrl / pull.deltaUrl). Webhook-ови могу да обавесте издавача или, након преузимања, помогну Вашем тиму да покрене чишћење CDN-а (purge) или ажурира огласну понуду на тржишту (marketplace). PhotoRobot Cloud сада говори Вашим језиком у продукционим интеграцијама.

‍

‍

‍

Сигнал, па преузимање

Payload-и су намерно мали. Сваки payload наводи догађај, организацију и (када је релевантно) ставку, као и pull.itemUrl и pull.deltaUrl. Payload-и не садрже бинарне датотеке слика, комплетна стабла фасцикли нити потпун запис о производу.

Програмери би требало да имплементирају следећи образац:

1. Примите POST захтев и проверите X-PhotoRobot-Signature у односу на сирово тело (raw body) захтева.
2. Брзо вратите одговор 2xx — DAM увоз или ажурирање на тржишту обавите у сопственом worker-у.
3. Уклоните дупликате према ID-у догађаја. Испорука је „најмање једном“ (at-least-once).
4. Преузмите актуелно стање са REST v2 хостинга помоћу pull URL адреса.

Управо та подела чини интеграцију поузданом. PhotoRobot не чека да се заврши Ваш посао у вези с каталогом, а Ваш систем никада не третира обавештење као каталог.

‍

‍

‍

Уобичајени примери коришћења Customer Webhooks

Најчешћи случајеви коришћења Customer Webhooks у PhotoRobot екосистему обухватају:

• Освежавање PIM или DAM система. Претплатите се на hosting.item.availability.changed. Када хостовани медији постану доступни за преузимање, преузмите itemUrl и ажурирајте производ – спинове, фотографије и метаподатке у једном пролазу.
• Објава понуде на тржишту (marketplace). Филтрирајте hosting догађаје на „Became downloadable“. Објавите или ажурирајте понуду тек пошто PhotoRobot заиста може да испоручи слике.
• Преглед статуса у производњи. Претплатите се на item.status.changed када Вашем ERP или QC систему треба информација да је ставка прешла у статус EDITED, APPROVED или PUBLISHED – чак и пре него што хостовање буде спремно.
• Масовно ажурирање кампања. Након велике промене статуса у систему Cloud стиже један item.status.bulk_changed догађај са deltaUrl адресом. Ускладите захваћени скуп ставки уместо да очекујете хиљаде webhook порука по ставци.
• Поништавање кеша или CDN-а. Када хостовање пређе у стање доступно или недоступно, обришите или унапред учитајте путање које Ваша веб-продавница већ познаје. Webhook је окидач, а Hosting API је извор нових URL адреса.

‍

‍

‍

Како да подесите Customer Webhooks

Да бисте подесили Customer Webhooks за PhotoRobot Cloud, отворите свој PhotoRobot Account у режиму Developers и помоћу опције Webhooks направите webhook претплату. Затим усмерите претплату на свој staging endpoint да бисте проверили прву испоруку.

‍

‍

1. Пријавите се у PhotoRobot Account и отворите Developers → Webhooks.
2. Направите webhook. Налепите свој HTTPS endpoint, дајте му интерни назив и изаберите догађаје који су Вам потребни.
3. Копирајте тајни кључ за потписивање када се појави – приказује се само једном, све док га не ротирате.
4. Кликните на Send test. Проверите да ли је стигао webhook.subscription.test и да ли се потпис успешно верификује.
5. Отворите Delivery log да бисте прегледали payload, HTTP статус и поновне покушаје.
6. Прву претплату усмерите на staging endpoint.

‍

‍

За више техничких информација, укључујући developer contract и примере потписа, погледајте PhotoRobot Developer Portal – Webhooks.

‍

‍