Cyflwyno: Customer Webhooks ar gyfer PhotoRobot Cloud

Customer Webhooks ar gyfer PhotoRobot Cloud

Gall eich datblygwyr a’ch timau TG nawr gysylltu PhotoRobot Cloud â’ch DAM, PIM, ERP neu awtomeiddio pwrpasol drwy webhooks allanol wedi’u llofnodi. Mae customer webhooks yn PhotoRobot Cloud yn darparu data dibynadwy sy’n cael ei yrru gan ddigwyddiadau – gan sicrhau cysylltedd llawn rhwng eich stiwdio a’ch systemau.

‍

‍

‍

Cau’r Cylch rhwng Eich Stiwdio a’ch Systemau

Sicrhewch fod eich systemau cysylltiedig yn gwybod pan fydd statws eitem yn newid neu pan fydd digwyddiad argaeledd lletya yn digwydd. Mae PhotoRobot Cloud Customer Webhooks yn danfon pob digwyddiad i’ch pwyntiau terfyn fel bod integreiddiadau’n parhau i gael eu gyrru gan ddigwyddiadau – yn hytrach na dibynnu ar holi cyson (polling).

Y digwyddiadau byw yw:

• item.status.changed – newid statws dal wedi’i gadarnhau ar un eitem.
• item.status.bulk_changed — un digwyddiad ar ôl newid statws swmp yn Cloud.
• hosting.item.availability.changed — mae cyfrwng sydd wedi’i letya wedi dod ar gael i’w lawrlwytho neu heb fod ar gael mwyach.
• webhook.subscription.test — Anfon prawf yn unig.

‍

‍

‍

Darparu Data Dibynadwy sy’n cael ei Yrru gan Ddigwyddiadau

Mae Customer Webhooks yn PhotoRobot Cloud yn cynnwys nodweddion ar gyfer:

• Tanysgrifiadau webhook allanol a reolir ochr yn ochr â’ch integreiddiadau datblygwr.
• Danfon HTTP wedi’i lofnodi fel y gall y derbynyddion wirio dilysrwydd.
• ‘Send test’ a hidlyddion i gadarnhau’r tanysgrifiad webhook a’r gwiriad llofnod.
• Log danfon i archwilio’r llwyth data (payload), statws HTTP ac ailgynnig.
• Rhyngwyneb datblygwr o dan Webhooks — mae webhooks a danfoniadau wrth ymyl allweddi API.

‍

‍

‍

Siarad Eich Iaith ar gyfer Integreiddiadau Cynhyrchu

Customer Webhooks yw’r ddolen goll rhwng dal robotig a systemau cofnodion y cwmni. Signal wedi’i lofnodi yw’r webhook, sy’n cario llwythi data bach yn unig yn fwriadol. Ar ôl 2xx, mae’r integreiddiad yn tynnu’r eitem gyfredol o REST v2 (pull.itemUrl / pull.deltaUrl). Gall webhooks hysbysu cyhoeddwr neu, ar ôl y tynnu, helpu eich tîm i gychwyn clirio storfa CDN neu ddiweddaru rhestriad ar farchnad ar-lein. Mae PhotoRobot Cloud bellach yn siarad eich iaith ar gyfer integreiddiadau cynhyrchu.

‍

‍

‍

Signal, Yna Tynnu

Mae’r llwythi data’n aros yn fach yn fwriadol. Mae pob llwyth data yn enwi’r digwyddiad, y sefydliad, a (pan fo’n berthnasol) yr eitem, ynghyd â pull.itemUrl a pull.deltaUrl. Nid yw’r llwythi data’n cario ffeiliau deuaidd delweddau, coed ffolderi llawn na chofnod cynnyrch cyflawn.

Y patrwm y dylai datblygwyr ei weithredu yw:

1. Derbyniwch y POST a gwiriwch X-PhotoRobot-Signature yn erbyn y corff crai.
2. Dychwelwch 2xx yn gyflym — gwnewch y mewnforio i’r DAM neu’r diweddariad marchnad yn eich proses worker eich hun.
3. Dad-ddyblygwch yn ôl ID y digwyddiad. Mae’r danfon yn digwydd o leiaf unwaith.
4. Estynnwch y cyflwr cyfredol o letya REST v2 gan ddefnyddio’r URLau tynnu.

Y gwahaniad hwn sy’n gwneud yr integreiddio’n ddibynadwy. Nid yw PhotoRobot yn aros i’ch tasg catalog orffen, ac nid yw eich system byth yn trin hysbysiad fel y catalog ei hun.

‍

‍

‍

Enghreifftiau Cyffredin o Customer Webhooks ar Waith

Mae’r achosion defnydd mwyaf cyffredin ar gyfer Customer Webhooks yn ecosystem PhotoRobot yn cynnwys:

• Adnewyddu PIM neu DAM. Tanysgrifiwch i hosting.item.availability.changed. Pan fydd cyfryngau a gynhelir ar gael i’w lawrlwytho, estynnwch itemUrl a diweddarwch y cynnyrch – troelliadau, delweddau llonydd a metadata ar un tro.
• Rhestru ar farchnadoedd. Hidlwch ddigwyddiadau hosting i ‘Became downloadable.’ Cyhoeddwch neu ddiweddarwch y rhestriad dim ond pan all PhotoRobot ddarparu’r delweddau mewn gwirionedd.
• Gwelededd ar y bwrdd cynhyrchu. Tanysgrifiwch i item.status.changed pan fydd angen i’ch ERP neu’ch bwrdd QC wybod bod eitem wedi symud i EDITED, APPROVED neu PUBLISHED – hyd yn oed cyn i’r hosting fod yn barod.
• Diweddariadau ymgyrch swmp. Ar ôl newid statws mawr yn Cloud, daw un digwyddiad item.status.bulk_changed gyda deltaUrl. Cydweddwch y set yr effeithiwyd arni yn hytrach na disgwyl miloedd o webhooks fesul eitem.
• Annilysu storfa neu CDN. Pan fydd hosting yn newid i fod ar gael neu ddim ar gael, cliriwch neu gynheswch y llwybrau y mae eich siop eisoes yn eu hadnabod. Y webhook yw’r sbardun; Hosting API yw ffynhonnell yr URLau newydd.

‍

‍

‍

Sut i Ffurfweddu Eich Customer Webhooks

I sefydlu Customer Webhooks ar gyfer PhotoRobot Cloud, agorwch eich PhotoRobot Account yn y modd Developers a defnyddiwch Webhooks i greu tanysgrifiad webhook. Yna, pwyntiwch y tanysgrifiad at eich pwynt terfyn profi i wirio’r danfoniad cyntaf.

‍

‍

1. Mewngofnodwch i PhotoRobot Account ac agorwch Developers → Webhooks.
2. Crëwch webhook. Gludwch eich pwynt terfyn HTTPS, rhowch enw mewnol iddo, a dewiswch y digwyddiadau sydd eu hangen arnoch.
3. Copïwch y gyfrinach lofnodi pan fydd yn ymddangos – fe’i dangosir unwaith nes i chi ei newid.
4. Cliciwch Send test. Cadarnhewch fod webhook.subscription.test yn cyrraedd a bod y llofnod yn dilysu.
5. Agorwch Delivery log i archwilio’r llwyth data, statws HTTP ac ailgynnig.
6. Pwyntiwch y tanysgrifiad cyntaf at bwynt terfyn profi.

‍

‍

I gael rhagor o wybodaeth dechnegol, gan gynnwys contract y datblygwr ac enghreifftiau o lofnodion, ewch i PhotoRobot Developer Portal – Webhooks.

‍

‍