מציגים: Webhooks ללקוחות עבור PhotoRobot Cloud

ווי רשת ללקוחות עבור PhotoRobot Cloud

המפתחים וצוותי ה-IT שלכם יכולים כעת לחבר את PhotoRobot Cloud ל-DAM, PIM, ERP או אוטומציה מותאמת אישית באמצעות ווב-ווקס יוצאים חתומים. הוקסים ללקוחות ב-PhotoRobot Cloud מציעים אספקת נתונים אמינה ומבוססת אירועים – ומבטיחים חיבור מלא בין הסטודיו למערכות.

‍

‍

‍

סגור את הלולאה בין הסטודיו שלך למערכות

ודאו שהמערכות שלכם יודעות מתי מצב פריט משתנה או מתרחש אירוע זמינות של ארחון. PhotoRobot Cloud Webhooks מספקים כל אירוע לנקודות הקצה שלכם כדי שהאינטגרציות יישארו מונחות אירועים – לא מבוססות סקרים.

האירועים החיים הם:

• item.status.changed – ביצוע שינוי מצב לכידה על פריט אחד.
• item.status.bulk_changed — אירוע אחד לאחר שינוי סטטוס בענן בכמויות גדולות.
• hosting.item.availability.changed — מדיה מאוחסנת הפכה לניתנת להורדה או לא זמינה.
• webhook.subscription.test — שלח בדיקה בלבד.

‍

‍

‍

אספקת נתונים אמינה ומונעת אירועים

Webhooks ללקוחות ב-PhotoRobot Cloud כוללים תכונות עבור:

• מנויים יוצאים ל-webhook מנוהלים לצד האינטגרציות של המפתחים שלך.
• משלוח HTTP חתום כדי שמקבלים יוכלו לאמת אותנטיות.
• "שלח בדיקה" וסינון לאישור מנוי webhook ואימות חתימה.
• יומן משלוח לבדיקת המטען, מצב HTTP וחזרות.
• ממשק משתמש למפתחים תחת Webhooks — webhooks ומשלוחים נמצאים ליד מפתחות API.

‍

‍

‍

לדבר בשפה שלך לאינטגרציות הפקה

Webhooks ללקוחות הם החוליה החסרה בין לכידה רובוטית לבין מערכות רשומות של החברה. ה-webhook הוא אות חתום, שנושא בכוונה מטענים קטנים בלבד. לאחר 2xx, האינטגרציה מושכת את הפריט הנוכחי מ-REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks יכולים להודיע למפיץ, או, לאחר המשיכה, לסייע לצוות שלך להתחיל ניקוי CDN או עדכון רשימת מרקטפלייס. PhotoRobot Cloud מדבר כעת בשפתך לאינטגרציות ייצור.

‍

‍

‍

סימן, ואז משיכה

המטענים נשארים קטנים בכוונה. כל מטען מציין את האירוע, את הארגון, ו (כאשר רלוונטי) את הפריט, בנוסף ל-pull.itemUrl ו-pull.deltaUrl. מטענים אינם נושאים בינארי תמונה, עצי תיקיות מלאים או רשומת מוצר מלאה.

התבניות שמפתחים צריכים ליישם היא:

1. קבל את ה-POST ואמת את X-PhotoRobot-Signature מול הגוף הגולמי.
2. החזר 2xx במהירות — בצע את ייבוא ה-DAM או עדכון השוק אצל העובד שלך.
3. הסרת שכפול לפי מזהה אירוע. המסירה היא לפחות פעם אחת.
4. שלף את המצב הנוכחי מאירוח REST v2 באמצעות כתובות המשיכה.

הפיצול הזה הוא מה שהופך את האינטגרציה לאמינה. PhotoRobot לא מחכה לסיום עבודת הקטלוג שלך, והמערכת שלך אף פעם לא מתייחסת להתראות כאל הקטלוג.

‍

‍

‍

דוגמאות נפוצות ל-Webhooks ללקוחות בשימוש

מקרי השימוש הנפוצים ביותר ב-Customer Webhooks באקוסיסטם של PhotoRobot כוללים:

• רענון PIM או DAM. הירשמו ל-hosting.item.availability.changed. כאשר מדיה מאוחסנת הופכת לניתנת להורדה, משוך את itemUrl ועדכן את המוצר — סיבובים, תמונות סטילס ומטא-דאטה במעבר אחד.
• רישום במרקטפלייס. סנן אירועי אירוח ל"הפך להורדה." פרסם או עדכן את הרשימה רק לאחר ש-PhotoRobot יכול להגיש את התמונות.
• נראות בלוח הייצור. הירשמו ל-item.status.changed כאשר לוחית ה-ERP או בקרת האיכות שלכם צריך לדעת שפריט הועבר ל-EDITED, APPROVED או PUBLISHED — אפילו לפני שהאחסון מוכן.
• עדכוני קמפיין בכמויות גדולות. לאחר שינוי סטטוס גדול בענן, מגיע אירוע item.status.bulk_changed אחד עם דלתא-URL. תעדכן את הסט המושפע במקום לצפות לאלפי וו-ווק לכל פריט.
• ביטול מטמון או CDN. כאשר האחסון עובר לזמין או לא זמין, מחק או חמם את הנתיבים שהחנות שלך כבר מכירה. ה-webhook הוא הטריגר; API האחסון הוא המקור לכתובות ה-URL החדשות.

‍

‍

‍

איך להגדיר את ה-Webhooks של הלקוחות שלך

כדי להגדיר Customer Webhooks ל-PhotoRobot Cloud, פתח את חשבון ה-PhotoRobot שלך במצב מפתחים והשתמש ב-Webhooks כדי ליצור מנוי ל-webhook. לאחר מכן, הפנה את המנוי לנקודת הקצה של הסטאז'ינג שלך כדי לאמת את המשלוח הראשון.

‍

‍

1. התחבר לחשבון PhotoRobot ופתח מפתחים →-Webhooks.
2. צור webhook. הדביק את נקודת הקצה של ה-HTTPS שלך, תן לה שם פנימי, ובחר את האירועים שאתה צריך.
3. העתק את סוד החתימה כשהוא מופיע — הוא מוצג פעם אחת עד שאתה מסובב אותו.
4. לחץ על שליחת בדיקה. אשר ש-webhook.subscription.test מגיע והחתימה מאומתת.
5. פתח את יומן המשלוח כדי לבדוק את המטען, מצב ה-HTTP והחזרות.
6. כוון את המנוי הראשון לנקודת קצה סטייג'ינג.

‍

‍

למידע טכני נוסף כולל דוגמאות לחוזי מפתחים וחתימות, עיינו בפורטל המפתחים PhotoRobot – Webhooks.

‍

‍