Introducere: Webhook-uri pentru clienți pentru PhotoRobot Cloud

Webhook-uri pentru clienți pentru PhotoRobot Cloud

Dezvoltatorii și echipele IT pot conecta acum PhotoRobot Cloud la automatizarea ta DAM, PIM, ERP sau personalizată cu webhook-uri semnate outbound. Webhook-urile clienților din PhotoRobot Cloud oferă livrare fiabilă a datelor, bazată pe evenimente – asigurând conectivitate completă între studioul tău și sisteme.

‍

‍

‍

Închide cercul dintre studioul tău și sistemele tale

Asigură-te că sistemele tale din aval știu când starea unui articol se schimbă sau când apare un eveniment de disponibilitate a găzduirii. PhotoRobot Cloud Customer Webhooks livrează fiecare eveniment către endpoint-urile tale, astfel încât integrările să rămână orientate pe evenimente – nu bazate pe interogări.

Evenimentele live sunt:

• item.status.changed – a activat schimbarea de capturare a statutului pe un singur articol.
• item.status.bulk_changed — la un eveniment după schimbarea de stare a Cloud Bulk.
• hosting.item.availability.changed — media găzduită a devenit descărcabilă sau indisponibilă.
• webhook.subscription.test — Trimiteți doar testul.

‍

‍

‍

Livrare fiabilă, bazată pe evenimente

Webhook-urile clienților din PhotoRobot Cloud includ funcții pentru:

• Abonamentele outbound webhook gestionate împreună cu integrările tale cu dezvoltatorii.
• Livrare HTTP semnată pentru ca receptorii să poată verifica autenticitatea.
• "Trimite testul" și filtre pentru a confirma abonamentul webhook și verificarea semnăturii.
• Jurnal de livrare pentru a inspecta payload-ul, statusul HTTP și retentările.
• Interfața dezvoltatorului sub Webhooks — webhook-urile și livrările sunt alături de cheile API.

‍

‍

‍

Vorbirea limbajului pentru integrări de producție

Webhook-urile clienților sunt veriga lipsă dintre capturarea robotizată și sistemele de înregistrare ale companiei. Webhook-ul este un semnal semnat, transportând intenționat doar sarcini mici utile. După 2xx, integrarea extrage elementul curent din REST v2 (pull.itemUrl / pull.deltaUrl). Webhook-urile pot notifica un publisher sau, după extragere, pot facilita echipa ta să declanșeze o eliminare CDN sau să actualizeze o listare pe piață. PhotoRobot Cloud vorbește acum limba ta pentru integrările de producție.

‍

‍

‍

Un semnal, apoi o tragere

Sarcinile utile rămân mici intenționat. Fiecare încărcătură utilă denumește evenimentul, organizația și (când este relevant) elementul, plus pull.itemUrl și pull.deltaUrl. Încărcăturile utile nu poartă binare de imagine, arbori de foldere întregi sau o înregistrare completă a produsului.

Modelul pe care dezvoltatorii ar trebui să-l implementeze este:

1. Primește POST-ul și verifică X-PhotoRobot-Signature pe corpul brut.
2. Returnează rapid 2xx — fă importul DAM sau actualizarea de pe piață în propriul tău angajat.
3. Deduplicarea după ID-ul evenimentului. Livrarea are loc cel puțin o dată.
4. Preia starea curentă din REST v2 folosind URL-urile de extragere.

Această divizare este ceea ce face integrarea fiabilă. PhotoRobot nu așteaptă să se termine lucrarea ta de catalog, iar sistemul tău nu tratează niciodată o notificare ca pe un catalog.

‍

‍

‍

Exemple comune de webhook-uri pentru clienți folosite

Cele mai frecvente cazuri de utilizare pentru Customer Webhook-urile în ecosistemul PhotoRobot includ:

• PIM sau DAM refresh. Abonează-te la hosting.item.availability.changed. Când media găzduită devine descărcabilă, extrage itemUrl și actualizează produsul — spin-uri, fotografii și metadate într-o singură trecere.
• Listare pe Marketplace. Filtrează evenimentele de găzduire la "A devenit descărcabil." Publică sau actualizează listarea doar după ce PhotoRobot poate servi efectiv imaginile.
• Vizibilitate a plăcii de producție. Abonează-te la item.status.changed atunci când placa ta ERP sau QC are nevoie să știe că un articol a fost mutat în EDITED, APPROVED sau PUBLISHED — chiar înainte ca găzduirea să fie gata.
• Actualizări de campanie în masă. După o schimbare majoră de status în Cloud, un eveniment item.status.bulk_changed apare cu un deltaUrl. Recuperează setul afectat în loc să te aștepți la mii de webhook-uri per obiect.
• Invalidare cache sau CDN. Când găzduirea se schimbă la disponibil sau indisponibil, elimină sau încălzește căile pe care magazinul tău deja le cunoaște. Webhook-ul este declanșatorul; API-ul de găzduire este sursa noilor URL-uri.

‍

‍

‍

Cum să configurezi webhook-urile clienților tăi

Pentru a configura Customer Webhooks pentru PhotoRobot Cloud, deschideți contul PhotoRobot în modul Developers și folosiți Webhooks pentru a crea un abonament webhook. Apoi, îndreptați abonamentul către punctul final de staging pentru a verifica prima livrare.

‍

‍

1. Conectează-te la PhotoRobot cont și deschide Developers → Webhooks.
2. Creează un webhook. Lipește endpoint-ul HTTPS, dă-i un nume intern și alege evenimentele de care ai nevoie.
3. Copiază secretul semnării când apare — este afișat o dată până îl rotești.
4. Apasă pe Trimite test. Confirmă că sosește webhook.subscription.test și semnătura verifică.
5. Deschide jurnalul de livrare pentru a inspecta payload-ul, statusul HTTP și reîncercările.
6. Îndreaptă primul abonament către un punct final de stație.

‍

‍

Pentru mai multe informații tehnice, inclusiv exemple de contracte cu dezvoltatori și semnături, consultați PhotoRobot Developer Portal – Webhooks.

‍

‍