Bekendstelling: Kliëntwebhooks vir PhotoRobot Cloud

Kliëntwebhooks vir PhotoRobot Cloud

Jou ontwikkelaars en IT-spanne kan nou PhotoRobot Cloud koppel aan jou DAM, PIM, ERP, of pasgemaakte outomatisering met ondertekende uitgaande webhooks. Kliëntwebhooks in PhotoRobot Cloud bied betroubare, gebeurtenisgedrewe datalewering – wat volle konnektiwiteit tussen jou ateljee en stelsels verseker.

‍

‍

‍

Maak die lus tussen jou ateljee en stelsels toe

Maak seker jou afwaartse stelsels weet wanneer 'n itemstatus verander of 'n gasheer-beskikbaarheidsgebeurtenis plaasvind. PhotoRobot Cloud Customer Webhooks lewer elke gebeurtenis na jou eindpunte sodat integrasies gebeurtenisgedrewe bly – nie peilingsgebaseerd nie.

Die lewendige geleenthede is:

• item.status.changed – het 'n vasleggingsstatusverandering op een item gepleeg.
• item.status.bulk_changed — een gebeurtenis na 'n Cloud-massastatusverandering.
• hosting.item.availability.changed — gehoste media het aflaaibaar of onbeskikbaar geword.
• webhook.subscription.test — Stuur slegs toets.

‍

‍

‍

Betroubare, gebeurtenisgedrewe data-aflewering

Kliëntwebhooks in PhotoRobot Cloud sluit funksies in vir:

• Uitgaande webhook-intekeninge word saam met jou ontwikkelaarintegrasies bestuur.
• Ondertekende HTTP-aflewering sodat ontvangers egtheid kan verifieer.
• "Stuur toets" en filters om webhook-intekening en handtekeningverifikasie te bevestig.
• Afleweringslogboek om die vrag, HTTP-status, en herpogings te inspekteer.
• Ontwikkelaar-koppelvlak onder Webhooks — webhooks en aflewerings lewendig langs API-sleutels.

‍

‍

‍

Jou Taal Praat vir Produksie-integrasies

Kliënt-webhooks is die ontbrekende skakel tussen gerobotiseerde vaslegging en maatskappy-rekordstelsels. Die webhook is 'n ondertekende sein wat doelbewus net klein vragte dra. Na 2xx trek die integrasie die huidige item uit REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks kan 'n uitgewer in kennis stel, of, na die trek, jou span help om 'n CDN-suiwering te begin of 'n marklys op te dateer. PhotoRobot Cloud praat nou jou taal vir produksie-integrasies.

‍

‍

‍

'n Sein, dan 'n trek

Vragte bly doelbewus klein. Elke vrag noem die gebeurtenis, die organisasie, en (waar relevant) die item, plus pull.itemUrl en pull.deltaUrl. Vragte dra nie beeldbinêre lêers, volledige vouerbome of 'n volledige produkrekord nie .

Die patroon wat ontwikkelaars moet implementeer is:

1. Ontvang die POST en verifieer X-PhotoRobot-Signature teen die rou liggaam.
2. Stuur 2xx vinnig terug — doen die DAM-invoer of markplekopdatering in jou eie werker.
3. Dedupliseer per gebeurtenis-ID. Aflewering is ten minste een keer.
4. Haal die huidige toestand van REST v2 hosting op deur die pull URL's te gebruik.

Daardie skeiding is wat die integrasie betroubaar maak. PhotoRobot wag nie vir jou kataloguswerk om klaar te wees nie, en jou stelsel behandel nooit 'n kennisgewing as die katalogus nie.

‍

‍

‍

Algemene Voorbeelde van Kliëntwebhooks in Gebruik

Die mees algemene gebruiksgevalle vir Kliënt-webhooks in die PhotoRobot-ekosisteem sluit in:

• PIM of DAM verfris. Teken in op hosting.item.availability.changed. Wanneer gehoste media aflaaibaar word, trek itemUrl en werk die produk op — spins, stilbeelde en metadata in een pas.
• Markpleklys. Filter gasheergeleenthede na "Afgelaaibaar geword." Publiseer of werk die lys eers op nadat PhotoRobot die beelde werklik kan bedien.
• Produksiebord-sigbaarheid. Teken in op item.status.changed wanneer jou ERP- of QC-bord moet weet dat 'n item na WYSIG, GOEDGEKEUR, of GEPUBLISEER is — selfs voordat hosting gereed is.
• Grootmaatveldtogopdaterings. Na 'n groot statusverandering in die Wolk, arriveer een item.status.bulk_changed gebeurtenis met 'n deltaUrl. Haal die betrokke stel in in plaas daarvan om duisende per-item webhooks te verwag.
• Kas- of CDN-ongeldigmaking. Wanneer hosting omskakel na beskikbaar of onbeskikbaar, verwyder of verhit die paaie wat jou winkelfront reeds ken. Die webhook is die sneller; Gasheer-API is die bron van die nuwe URL's.

‍

‍

‍

Hoe om jou kliënt-webhooks te konfigureer

Om Customer Webhooks vir PhotoRobot Cloud op te stel, open jou PhotoRobot-rekening in Developers-modus en gebruik Webhooks om 'n webhook-intekening te skep. Wys dan die intekening na jou staging-eindpunt om die eerste aflewering te verifieer.

‍

‍

1. Meld aan by PhotoRobot rekening en maak Ontwikkelaars → Webhooks oop.
2. Skep 'n webhook. Plak jou HTTPS-eindpunt, gee dit 'n interne naam, en kies die gebeure wat jy nodig het.
3. Kopieer die ondertekeningsgeheim wanneer dit verskyn — dit word een keer gewys totdat jy dit roteer.
4. Klik Stuur toets. Bevestig webhook.subscription.test arriveer en die handtekening verifieer.
5. Maak die afleweringslogboek oop om die vrag, HTTP-status en herpogings te inspekteer.
6. Rig die eerste intekening op 'n staging-eindpunt.

‍

‍

Vir meer tegniese inligting, insluitend voorbeelde van ontwikkelaarskontrakte en handtekeninge, verwys na PhotoRobot Developer Portal – Webhooks.

‍

‍