Uudis: Customer Webhooks teenusele PhotoRobot Cloud

Customer Webhooks teenusele PhotoRobot Cloud

Teie arendajad ja IT-meeskonnad saavad nüüd ühendada teenuse PhotoRobot Cloud oma DAM-i, PIM-i, ERP-i või individuaalse automatiseerimislahendusega allkirjastatud väljaminevate webhookide abil. Customer Webhooks teenuses PhotoRobot Cloud tagavad usaldusväärse sündmuspõhise andmeedastuse – ja täieliku ühenduvuse teie stuudio ja süsteemide vahel.

‍

‍

‍

Sulgege ring teie stuudio ja süsteemide vahel

Tagage, et teie järgnevad süsteemid teavad, millal objekti staatus muutub või tekib majutuse saadavusega seotud sündmus. PhotoRobot Cloud Customer Webhooks edastavad iga sündmuse teie lõpp-punktidele, nii et integratsioonid jäävad sündmuspõhiseks – mitte pollingupõhiseks.

Praegu toetatud sündmused on:

• item.status.changed – ühe objekti salvestusstaatuse kinnitatud muutus.
• item.status.bulk_changed — üks sündmus pärast Cloudi hulgistaatuse muutmist.
• hosting.item.availability.changed — majutatud meedia muutus allalaaditavaks või kättesaamatuks.
• webhook.subscription.test — ainult testi saatmine.

‍

‍

‍

Usaldusväärne sündmuspõhine andmeedastus

Customer Webhooks teenuses PhotoRobot Cloud sisaldavad järgmisi funktsioone:

• Väljaminevate webhookide tellimused, mida haldate koos oma arendusintegratsioonidega.
• Allkirjastatud HTTP-edastus, et vastuvõtjad saaksid autentsust kontrollida.
• „Send test“ ja filtrid webhooki tellimuse ja allkirja kontrolli kinnitamiseks.
• Edastuslogi andmesisu (payload), HTTP-staatuse ja korduskatsete kontrollimiseks.
• Arendaja kasutajaliides jaotises Webhooks — webhookid ja edastused asuvad API-võtmete kõrval.

‍

‍

‍

Räägime teie keelt tootmisintegratsioonides

Customer Webhooks on puuduv lüli robotiseeritud pildistamise ja ettevõtte põhisüsteemide vahel. Webhook on allkirjastatud signaal, mis kannab meelega vaid väikest andmemahtu. Pärast vastust 2xx tõmbab integratsioon kehtiva objekti REST v2-st (pull.itemUrl / pull.deltaUrl). Webhookid võivad teavitada avaldajat või aitavad pärast andmete pärimist teie meeskonnal käivitada CDN-i puhastuse või uuendada turuplatsi kuulutust. PhotoRobot Cloud räägib nüüd tootmisintegratsioonides teie keelt.

‍

‍

‍

Signaal ja seejärel andmete pärimine

Andmemaht jääb meelega väikeseks. Iga andmepakett nimetab sündmuse, organisatsiooni ja (vajaduse korral objekti), lisaks pull.itemUrl ja pull.deltaUrl. Andmepaketid ei sisalda pildifaile, täielikke kaustapuid ega täielikku tootekirjet.

Arendajatel tuleks rakendada järgmine muster:

1. Võtke POST vastu ja kontrollige X-PhotoRobot-Signature väärtust töötlemata sisu alusel.
2. Tagastage 2xx kiiresti — tehke DAM-i import või turuplatsi uuendus oma töötlejas (worker).
3. Eemaldage duplikaadid sündmuse ID järgi. Edastus toimub vähemalt üks kord (at-least-once).
4. Tõmmake kehtiv olek REST v2 majutusest, kasutades pull-URL-e.

Just see eristus teebki integratsiooni töökindlaks. PhotoRobot ei oota teie kataloogitöö lõppemist ja teie süsteem ei käsitle teavitust kunagi kataloogina.

‍

‍

‍

Customer Webhooks’i levinumad kasutusnäited

Customer Webhooks’i levinumad kasutusjuhud PhotoRobot ökosüsteemis on järgmised:

• PIM- või DAM-süsteemi värskendamine. Tellige sündmus hosting.item.availability.changed. Kui majutatud meedia muutub allalaaditavaks, tõmmake itemUrl ja uuendage toodet – pöördvaated, fotod ja metaandmed ühe korraga.
• Turuplatsi kuulutus. Filtreerige hostingu sündmused väärtusele „Became downloadable“. Avaldage või uuendage kuulutust alles siis, kui PhotoRobot suudab pilte tegelikult edastada.
• Tootmise ülevaade. Tellige item.status.changed, kui teie ERP- või kvaliteedikontrolli tahvel peab teadma, et üksus on liikunud olekusse EDITED, APPROVED või PUBLISHED – isegi enne, kui hosting on valmis.
• Kampaaniate masspäevitused. Pärast ulatuslikku olekumuudatust teenuses Cloud saabub üks item.status.bulk_changed sündmus koos deltaUrl-iga. Sünkroonige mõjutatud komplekt, selle asemel et oodata tuhandeid üksikuid webhook’e.
• Vahemälu või CDN-i tühistamine. Kui hosting muutub kättesaadavaks või kättesaamatuks, tühjendage või eelsoojendage need teed, mis on teie e-poele juba teada. Webhook on päästik; Hosting API on uute URL-ide allikas.

‍

‍

‍

Kuidas Customer Webhooks seadistada

Customer Webhooks’i seadistamiseks teenuses PhotoRobot Cloud avage oma PhotoRobot Account režiimis Developers ja looge Webhooks’i abil webhooki tellimus. Seejärel suunake tellimus oma testkeskkonna lõpp-punkti, et kontrollida esimest edastust.

‍

‍

1. Logige sisse kontole PhotoRobot Account ja avage Developers → Webhooks.
2. Looge webhook. Kleepige oma HTTPS-lõpp-punkt, andke sellele sisemine nimi ja valige vajalikud sündmused.
3. Kopeerige allkirjastamise saladus, kui see ilmub – seda näidatakse ainult üks kord, kuni te selle uuesti vahetate.
4. Klõpsake Send test. Veenduge, et webhook.subscription.test saabub ja allkiri kinnitub.
5. Avage Delivery log, et kontrollida andmemahtu (payload), HTTP-olekut ja korduskatseid.
6. Suunake esimene tellimus testkeskkonna lõpp-punkti.

‍

‍

Lisateavet, sealhulgas arendajalepingut ja allkirjanäiteid, leiate jaotisest PhotoRobot Developer Portal – Webhooks.

‍

‍