تقديم: هوايات الويب الخاصة بالعملاء ل PhotoRobot Cloud

روابط الويب الخاصة بالعملاء ل PhotoRobot Cloud

يمكن لمطوريك وفرق تقنية المعلومات الآن توصيل PhotoRobot Cloud بنظام DAM أو PIM أو ERP أو أتمتتك المخصصة عبر خطوط ويب صادرة موقعة. توفر خطافات الويب الخاصة بالعملاء في PhotoRobot Cloud توصيل بيانات موثوق وقائم على الأحداث – مما يضمن اتصالا كاملا بين الاستوديو والأنظمة.

‍

‍

‍

أغلق الحلقة بين الاستوديو والأنظمة

تأكد من أن أنظمتك اللاحقة تعرف عندما يتغير حالة العنصر أو يحدث حدث توفر الاستضافة. تقوم PhotoRobot Cloud Web hooks بتوصيل كل حدث إلى نقاط النهاية الخاصة بك حتى تبقى التكاملات مدفوعة بالأحداث – وليس قائمة على الاستطلاعات.

الفعاليات الحية هي:

• item.status.changed – ارتكب تغيير حالة الاستيلاء على عنصر واحد.
• item.status.bulk_changed — حدث واحد بعد تغيير حالة السحابة بشكل جماعي.
• hosting.item.availability.changed — أصبحت الوسائط المستضافة قابلة للتحميل أو غير متوفرة.
• webhook.subscription.test — إرسال اختبار فقط.

‍

‍

‍

توصيل بيانات موثوق وقائم على الأحداث

تشمل هوايات الويب الخاصة بالعملاء في 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 باستخدام عناوين URL.

هذا التقسيم هو ما يجعل التكامل موثوقا. PhotoRobot لا ينتظر حتى ينتهي عمل الكتالوج الخاص بك، ونظامك لا يعامل الإشعار ككتالوج.

‍

‍

‍

أمثلة شائعة على استخدام شبكات الويب الخاصة بالعملاء

أكثر حالات الاستخدام شيوعا لهواكس الويب الخاصة بالعملاء في نظام PhotoRobot البيئي تشمل:

• تحديث PIM أو DAM. اشترك في hosting.item.availability.changed. عندما تصبح الوسائط المستضافة قابلة للتنزيل، قم بسحب itemURL وتحديث المنتج — الدوران، الصور الثابتة، والبيانات الوصفية في تمريرة واحدة.
• قائمة السوق. تصفية أحداث استضافة إلى "أصبحت قابلة للتنزيل". انشر أو حدث القائمة فقط بعد أن يتمكن PhotoRobot من عرض الصور فعليا.
• رؤية لوحة الإنتاج. اشترك في item.status.changed عندما تحتاج لوحة ERP أو QC الخاصة بك إلى معرفة العنصر الذي تم نقله إلى EDITED أو APPROVED أو PUBLISHED — حتى قبل أن تكون الاستضافة جاهزة.
• تحديثات الحملة الجماعية. بعد تغيير كبير في الحالة في السحابة، يأتي حدث item.status.bulk_changed مع رابط دلتا. تابع المجموعة المتأثرة بدلا من توقع آلاف الروابط لكل عنصر.
• إلغاء التحقق من ذاكرة التخزين المؤقت أو CDN. عند تحويل الاستضافة إلى متاح أو غير متاح، قم بحذف أو تسخين المسارات التي يعرفها متجرك بالفعل. الويبهوك هو المحفز؛ واجهة برمجة التطبيقات للاستضافة هي مصدر الروابط الجديدة.

‍

‍

‍

كيفية تكوين خصلات الويب الخاصة بعملائك

لإعداد Web hooks للعملاء ل PhotoRobot Cloud، افتح حسابك في PhotoRobot في وضع المطورين واستخدم Webhooks لإنشاء اشتراك webhook. ثم وجه الاشتراك إلى نقطة نهاية الترتيب للتحقق من أول تسليم.

‍

‍

1. سجل الدخول إلى PhotoRobot الحساب وافتح المطورين → Webhooks.
2. أنشئ webhook. الصق نقطة نهاية HTTPS الخاصة بك، أعطها اسما داخليا، واختر الأحداث التي تحتاجها.
3. انسخ سر التوقيع عند ظهوره — يظهر مرة واحدة حتى تدويره.
4. انقر على إرسال الاختبار. تأكد من وصول webhook.subscription.test ويتم التحقق من التوقيع.
5. افتح سجل التسليم لفحص الحمولة، حالة HTTP، والمحاولات.
6. وجه أول اشتراك إلى نقطة نهاية مرحلية.

‍

‍

لمزيد من المعلومات التقنية بما في ذلك عقود المطور وأمثلة التوقيع، يرجى الرجوع إلى بوابة مطوري PhotoRobot – Webhooks.

‍

‍