แนะนํา: Webhook สําหรับลูกค้าสําหรับ PhotoRobot Cloud

เว็บฮุกลูกค้าสําหรับ PhotoRobot Cloud

นักพัฒนาและทีมไอทีของคุณสามารถเชื่อมต่อ PhotoRobot Cloud กับ DAM, PIM, ERP หรือระบบอัตโนมัติแบบกําหนดเองด้วยเว็บฮุกขาออกที่เซ็นลายเซ็นเว็บฮุกของลูกค้าใน PhotoRobot Cloud มอบการส่งข้อมูลที่เชื่อถือได้และขับเคลื่อนด้วยเหตุการณ์ – รับประกันการเชื่อมต่อเต็มรูปแบบระหว่างสตูดิโอและระบบของคุณ

‍

‍

‍

ปิดวงจรระหว่างสตูดิโอกับระบบของคุณ

ตรวจสอบให้แน่ใจว่าระบบปลายทางของคุณทราบเมื่อสถานะสินค้าเปลี่ยนแปลงหรือเกิดเหตุการณ์โฮสติ้งพร้อมใช้งาน PhotoRobot Cloud Customer Webhooks ส่งแต่ละเหตุการณ์ไปยังอุปกรณ์ปลายทางของคุณ เพื่อให้การผสานรวมยังคงขับเคลื่อนด้วยเหตุการณ์ ไม่ใช่แบบสํารวจความคิดเห็น

กิจกรรมสดมีดังนี้:

• item.status.changed – การเปลี่ยนแปลงสถานะการจับภาพที่ผูกพันกับรายการหนึ่งรายการ
• item.status.bulk_changed — เหตุการณ์หนึ่งเหตุการณ์หลังจากเปลี่ยนสถานะ Cloud bulk
• hosting.item.availability.changed — สื่อที่โฮสต์กลายเป็นไฟล์ที่ดาวน์โหลดได้หรือไม่พร้อมใช้งาน
• webhook.subscription.test — ส่งเฉพาะการทดสอบเท่านั้น

‍

‍

‍

การส่งมอบข้อมูลที่เชื่อถือได้และขับเคลื่อนด้วยเหตุการณ์

Web hook ของลูกค้าใน PhotoRobot Cloud มีฟีเจอร์สําหรับ:

• การสมัครสมาชิก webhook ขาออก ที่จัดการควบคู่ไปกับการผสานรวมนักพัฒนาของคุณ
• การส่ง HTTP ที่ลงลายเซ็น เพื่อให้ผู้รับสามารถตรวจสอบความถูกต้องได้
• "ส่งการทดสอบ" และตัวกรอง เพื่อยืนยันการสมัครสมาชิกเว็บฮุกและการตรวจสอบลายเซ็น
• บันทึกการส่งมอบ เพื่อตรวจสอบข้อมูล, สถานะ HTTP และการลองใหม่
• UI สําหรับนักพัฒนาภายใต้ Webhooks — webhook และการส่งข้อมูลจะอยู่ข้าง API keys

‍

‍

‍

พูดภาษาของคุณสําหรับการผสานรวมกับการผลิต

Web hook ของลูกค้าเป็นสะพานที่ขาดหายไประหว่างการจับข้อมูลแบบอัตโนมัติกับระบบบันทึกของบริษัท webhook เป็นสัญญาณที่มีลายเซ็น โดยตั้งใจจะบรรจุ payload ขนาดเล็กเท่านั้นหลังจาก 2xx การผสานรวมจะดึงรายการปัจจุบันจาก REST v2 (pull.itemUrl / pull.deltaUrl)Webhooks สามารถแจ้งเตือนผู้เผยแพร่ หรือหลังจากดึงข้อมูล ช่วยทีมของคุณเริ่มต้นการล้าง CDN หรืออัปเดตรายการในตลาด PhotoRobot Cloud ตอนนี้สามารถสื่อสารภาษาของคุณสําหรับการผสานรวมในการผลิตได้

‍

‍

‍

สัญญาณ แล้วก็ดึง

เพย์โหลดยังคงมีขนาดเล็กโดยเจตนาแต่ละเพย์โหลดจะตั้งชื่อ เหตุการณ์ องค์กร และ (เมื่อเกี่ยวข้อง) รายการ รวมถึง pull.itemUrl และ pull.deltaUrl เพย์โหลด จะไม่มี ไบนารีภาพ ต้นไม้โฟลเดอร์เต็มรูปแบบ หรือระเบียนผลิตภัณฑ์ครบถ้วน

แพทเทิร์นที่นักพัฒนาควรนําไปใช้คือ:

1. รับ POST และตรวจสอบลายเซ็น X-PhotoRobot กับตัวเครื่องดิบ
2. ส่งคืน 2xx อย่างรวดเร็ว — ทําการนําเข้า DAM หรืออัปเดต marketplace ในโปรแกรมของคุณ
3. ลบข้อมูลซ้ําด้วยรหัสเหตุการณ์ การส่งมอบจะทําอย่างน้อยหนึ่งครั้ง
4. ดึงสถานะปัจจุบันจากโฮสติ้ง REST v2 โดยใช้ URL ดึงข้อมูล

การแยกส่วนนี้เองที่ทําให้การรวมระบบน่าเชื่อถือ PhotoRobot ไม่รอให้งานแคตตาล็อกของคุณเสร็จสิ้น และระบบของคุณจะไม่ถือว่าการแจ้งเตือนเป็นแคตตาล็อก

‍

‍

‍

ตัวอย่างทั่วไปของการใช้งานเว็บฮุกของลูกค้า

กรณีการใช้งานที่พบบ่อยที่สุดของ Customer Webhooks ในระบบนิเวศ PhotoRobot ได้แก่:

• รีเฟรช PIM หรือ DAM สมัครรับข้อมูลที่ hosting.item.availability.changed เมื่อมีสื่อที่โฮสต์สามารถดาวน์โหลดได้ ให้ดึง itemUrl และอัปเดตผลิตภัณฑ์ — สปิน ภาพนิ่ง และเมตาดาต้าในครั้งเดียว
• รายการในตลาดกรองกิจกรรมโฮสต์เป็น "ดาวน์โหลดได้แล้ว"เผยแพร่หรืออัปเดตรายการเฉพาะหลังจากที่ PhotoRobot สามารถให้บริการภาพได้จริง
• การมองเห็นบนบอร์ดการผลิต สมัครรับข้อมูล item.status.changed เมื่อบอร์ด ERP หรือบอร์ด QC ของคุณต้องการทราบว่ารายการถูกย้ายเป็น EDITED, APPROVED, หรือ PUBLISHED — แม้ก่อนที่โฮสต์จะพร้อม
• อัปเดตแคมเปญจํานวนมาก หลังจากมีการเปลี่ยนแปลงสถานะครั้งใหญ่ใน Cloud เหตุการณ์ item.status.bulk_changed event หนึ่งจะมาพร้อมกับ deltaUrl ตามให้ทันชุดที่ได้รับผลกระทบแทนที่จะคาดหวัง webhook ต่อรายการเป็นพัน ๆ รายการ
• การยกเลิกแคชหรือ CDN เมื่อโฮสติ้งเปลี่ยนเป็น พร้อมใช้งาน หรือ ไม่พร้อมใช้งาน ให้ลบหรืออุ่นเส้นทางที่ร้านค้าของคุณรู้อยู่แล้ว webhook คือตัวกระตุ้น;Hosting API คือแหล่งที่มาของ URL ใหม่

‍

‍

‍

วิธีการกําหนดค่าเว็บฮุกของลูกค้า

ในการตั้งค่า Customer Webhooks สําหรับ PhotoRobot Cloud ให้เปิดบัญชี PhotoRobot ของคุณในโหมดนักพัฒนา และใช้ Webhooks เพื่อสร้างการสมัครสมาชิก webhook จากนั้นชี้การสมัครสมาชิกไปยังจุดสิ้นสุดการจัดเตรียมเพื่อยืนยันการจัดส่งครั้งแรก

‍

‍

1. ลงชื่อเข้าใช้บัญชี PhotoRobot และเปิด Developers → Webhooks
2. สร้างเว็บฮุกวาง endpoint HTTPS ของคุณ ตั้งชื่อภายใน และเลือกเหตุการณ์ที่คุณต้องการ
3. คัดลอกความลับการลงนามเมื่อมันปรากฏ — จะแสดงเพียงครั้งเดียวจนกว่าคุณจะหมุนมัน
4. คลิก ส่งการทดสอบยืนยันว่า webhook.subscription.test มาถึงและลายเซ็นได้รับการยืนยัน
5. เปิด บันทึกการส่งมอบ เพื่อตรวจสอบเพย์โหลด สถานะ HTTP และการลองใหม่
6. ชี้การสมัครสมาชิกครั้งแรกไปยังจุดสิ้นสุดการจัดเตรียม

‍

‍

สําหรับข้อมูลทางเทคนิคเพิ่มเติม รวมถึงสัญญานักพัฒนาและตัวอย่างลายเซ็น โปรดดูที่ PhotoRobot Developer Portal – Webhooks

‍

‍