Jaunums: Customer Webhooks risinājumam PhotoRobot Cloud

Customer Webhooks risinājumam PhotoRobot Cloud

Jūsu izstrādātāji un IT komandas tagad var savienot PhotoRobot Cloud ar jūsu DAM, PIM, ERP vai individuāli veidotu automatizāciju, izmantojot parakstītus izejošos webhook. Customer webhooks sistēmā PhotoRobot Cloud nodrošina uzticamu, uz notikumiem balstītu datu piegādi – un pilnīgu savienojamību starp jūsu studiju un sistēmām.

‍

‍

‍

Noslēdziet ciklu starp savu studiju un sistēmām

Nodrošiniet, lai jūsu pakārtotās sistēmas zinātu, kad mainās vienuma statuss vai notiek hostinga pieejamības notikums. PhotoRobot Cloud Customer Webhooks nogādā katru notikumu uz jūsu galapunktiem, lai integrācijas paliktu balstītas uz notikumiem, nevis uz regulāru aptauju (polling).

Pašlaik pieejamie notikumi:

• item.status.changed – vienam vienumam apstiprināta uzņemšanas statusa maiņa.
• item.status.bulk_changed — viens notikums pēc Cloud masveida statusa maiņas.
• hosting.item.availability.changed — hostētie multivides faili kļuvuši lejupielādējami vai nepieejami.
• webhook.subscription.test — tikai testa sūtīšanai.

‍

‍

‍

Uzticama, uz notikumiem balstīta datu piegāde

Customer Webhooks sistēmā PhotoRobot Cloud ietver funkcijas:

• Izejošo webhook abonementi, ko pārvaldāt kopā ar savām izstrādātāju integrācijām.
• Parakstīta HTTP piegāde, lai saņēmēji varētu pārbaudīt autentiskumu.
• “Send test” un filtri, lai apstiprinātu webhook abonementu un paraksta pārbaudi.
• Piegādes žurnāls, lai pārbaudītu datu saturu (payload), HTTP statusu un atkārtotos mēģinājumus.
• Izstrādātāju saskarne sadaļā Webhooks — webhook un piegādes atrodas blakus API atslēgām.

‍

‍

‍

Runājam jūsu valodā ražošanas integrācijām

Customer Webhooks ir trūkstošā saikne starp robotizētu uzņemšanu un uzņēmuma uzskaites sistēmām. Webhook ir parakstīts signāls, kas ar nolūku satur tikai nelielu datu apjomu. Pēc 2xx atbildes integrācija no REST v2 izgūst aktuālo vienumu (pull.itemUrl / pull.deltaUrl). Webhook var paziņot publicētājam vai pēc datu izgūšanas palīdzēt jūsu komandai sākt CDN kešatmiņas tīrīšanu vai atjaunināt piedāvājumu tirgus vietnē. PhotoRobot Cloud tagad runā jūsu valodā ražošanas integrācijām.

‍

‍

‍

Signāls, pēc tam datu izgūšana

Datu apjoms ar nolūku paliek neliels. Katrā payload ir norādīts notikums, organizācija un (ja nepieciešams) vienums, kā arī pull.itemUrl un pull.deltaUrl. Payload nesatur attēlu bināros datus, pilnus mapju kokus vai pilnīgu produkta ierakstu.

Izstrādātājiem būtu jāievieš šāds modelis:

1. Saņemiet POST pieprasījumu un pārbaudiet X-PhotoRobot-Signature, salīdzinot ar neapstrādātu pieprasījuma pamattekstu.
2. Ātri atgrieziet 2xx — DAM importu vai tirgus vietnes atjaunināšanu veiciet savā fona procesā (worker).
3. Deduplicējiet pēc notikuma ID. Piegāde notiek vismaz vienu reizi (at-least-once).
4. Izgūstiet aktuālo stāvokli no REST v2 hostinga, izmantojot pull URL.

Tieši šis nodalījums padara integrāciju uzticamu. PhotoRobot negaida, kamēr tiks pabeigts jūsu kataloga uzdevums, un jūsu sistēma nekad neuzskata paziņojumu par pašu katalogu.

‍

‍

‍

Biežākie Customer Webhooks lietošanas piemēri

Biežākie Customer Webhooks lietošanas gadījumi PhotoRobot ekosistēmā ir šādi:

• PIM vai DAM atjaunināšana. Abonējiet hosting.item.availability.changed. Kad mitinātie mediji kļūst lejupielādējami, izgūstiet itemUrl un atjauniniet produktu — rotācijas attēlus, statiskos attēlus un metadatus vienā piegājienā.
• Tirdzniecības platformas piedāvājums. Filtrējiet hostinga notikumus pēc statusa “Became downloadable”. Publicējiet vai atjauniniet piedāvājumu tikai tad, kad PhotoRobot attēlus var faktiski piegādāt.
• Ražošanas progresa pārskatāmība. Abonējiet item.status.changed, ja jūsu ERP vai kvalitātes kontroles (QC) panelim jāzina, ka vienums ir pārgājis statusā EDITED, APPROVED vai PUBLISHED — pat pirms hostings ir gatavs.
• Masveida kampaņu atjauninājumi. Pēc plašas statusa maiņas Cloud tiek saņemts viens notikums item.status.bulk_changed ar deltaUrl. Sinhronizējiet skarto vienumu kopu, nevis gaidiet tūkstošiem atsevišķu webhook paziņojumu par katru vienumu.
• Kešatmiņas vai CDN invalidēšana. Kad hostinga statuss mainās uz pieejams vai nepieejams, notīriet vai iepriekš sasildiet ceļus, kurus jūsu veikala vietne jau zina. Webhook ir trigeris; Hosting API ir jauno URL avots.

‍

‍

‍

Kā konfigurēt Customer Webhooks

Lai iestatītu Customer Webhooks pakalpojumam PhotoRobot Cloud, atveriet savu PhotoRobot Account režīmā Developers un izmantojiet sadaļu Webhooks, lai izveidotu webhook abonementu. Pēc tam norādiet abonementam savu testa vides (staging) galapunktu, lai pārbaudītu pirmo piegādi.

‍

‍

1. Piesakieties PhotoRobot Account un atveriet Developers → Webhooks.
2. Izveidojiet webhook. Ievadiet savu HTTPS galapunktu, piešķiriet tam iekšējo nosaukumu un izvēlieties nepieciešamos notikumus.
3. Nokopējiet parakstīšanas noslēpumu (signing secret), kad tas tiek parādīts — tas tiek rādīts vienu reizi, līdz jūs to nomainīsiet.
4. Noklikšķiniet uz Send test. Pārliecinieties, ka webhook.subscription.test tiek saņemts un paraksts tiek veiksmīgi verificēts.
5. Atveriet Delivery log, lai pārbaudītu datu saturu (payload), HTTP statusu un atkārtotos mēģinājumus.
6. Pirmo abonementu norādiet uz testa vides (staging) galapunktu.

‍

‍

Plašāku tehnisko informāciju, tostarp izstrādātāja līgumu un parakstu piemērus, skatiet PhotoRobot Developer Portal – Webhooks.

‍

‍