Giới thiệu: Webhook khách hàng cho PhotoRobot Cloud
PhotoRobot giới thiệu Webhook Khách hàng cho PhotoRobot Cloud để kết nối DAM, PIM, ERP hoặc tự động hóa tùy chỉnh của bạn với webhook outbound đã ký.
Webhook khách hàng cho PhotoRobot Cloud
Các nhà phát triển và đội ngũ CNTT của bạn giờ đây có thể kết nối PhotoRobot Cloud với DAM, PIM, ERP hoặc tự động hóa tùy chỉnh của bạn bằng webhook outbound đã ký. Webhook khách hàng trong PhotoRobot Cloud cung cấp việc truyền dữ liệu đáng tin cậy, dựa trên sự kiện – đảm bảo kết nối đầy đủ giữa studio và hệ thống.
Đóng vòng lặp giữa Studio và hệ thống của bạn
Đảm bảo hệ thống hạ nguồn của bạn biết khi trạng thái mặt hàng thay đổi hoặc sự kiện khả dụng lưu trữ xảy ra. Webhook Khách hàng PhotoRobot Cloud sẽ truyền từng sự kiện đến các điểm cuối của bạn để tích hợp vẫn dựa trên sự kiện – không dựa trên thăm dò.
Các sự kiện trực tiếp bao gồm:
- item.status.changed – Thay đổi trạng thái bắt giữ đã cam kết trên một mục.
- item.status.bulk_changed — một sự kiện sau khi thay đổi trạng thái hàng loạt trên Cloud.
- hosting.item.availability.changed — Phương tiện lưu trữ trở thành có thể tải về hoặc không khả dụng.
- webhook.subscription.test — Chỉ gửi bài kiểm thử.
Truyền dữ liệu đáng tin cậy, dựa trên sự kiện
Webhook khách hàng trong PhotoRobot Cloud bao gồm các tính năng cho:
- Các gói đăng ký webhook ra ngoài được quản lý cùng với các tích hợp dành cho nhà phát triển.
- Giao HTTP đã ký để người nhận có thể xác minh tính xác thực.
- "Gửi bài kiểm tra" và bộ lọc để xác nhận đăng ký webhook và xác minh chữ ký.
- Nhật ký giao hàng để kiểm tra payload, trạng thái HTTP và thử lại.
- Giao diện nhà phát triển dưới Webhooks — webhook và giao hàng trực tiếp bên cạnh khóa API.
Nói ngôn ngữ của bạn cho tích hợp sản xuất
Webhook khách hàng là mắt xích còn thiếu giữa việc ghi nhận bằng robot và hệ thống lưu trữ của công ty. Webhook là tín hiệu có dấu, chủ đích mang các payload nhỏ. Sau 2xx, tích hợp sẽ lấy mục hiện tại từ REST v2 (pull.itemUrl / pull.deltaUrl). Webhook có thể thông báo cho nhà xuất bản, hoặc sau khi kéo, hỗ trợ nhóm của bạn khởi động quá trình xóa CDN hoặc cập nhật danh sách thị trường. PhotoRobot Cloud hiện nói ngôn ngữ của bạn cho các tích hợp sản xuất.
Một tín hiệu, rồi một lực kéo
Payload được giữ nhỏ một cách có chủ ý. Mỗi payload đặt tên cho sự kiện, tổ chức và (khi phù hợp) mục đó, cùng với pull.itemUrl và pull.deltaUrl. Payload không mang nhị phân hình ảnh, cây thư mục đầy đủ hoặc bản ghi sản phẩm đầy đủ.
Mẫu mà các nhà phát triển nên triển khai là:
- Nhận POST và xác minh chữ ký X-PhotoRobot với thân thô.
- Trả lại 2xx nhanh chóng — thực hiện nhập DAM hoặc cập nhật marketplace trong chính công việc của bạn.
- Loại bỏ trùng lặp theo ID sự kiện. Việc phân phối ít nhất một lần.
- Lấy trạng thái hiện tại từ REST v2 hosting bằng các URL kéo.
Sự phân chia đó chính là điều làm cho việc tích hợp trở nên đáng tin cậy. PhotoRobot không chờ công việc catalog của bạn hoàn thành, và hệ thống của bạn không bao giờ coi thông báo là catalog.
Các ví dụ phổ biến về Webhook của khách hàng đang được sử dụng
Các trường hợp sử dụng phổ biến nhất của Webhook Khách hàng trong hệ sinh thái PhotoRobot bao gồm:
- Làm mới PIM hoặc DAM. Đăng ký hosting.item.availability.changed. Khi các phương tiện lưu trữ trở nên có thể tải về, hãy lấy itemUrl và cập nhật sản phẩm — quay video, ảnh tĩnh và siêu dữ liệu cùng lúc.
- Danh sách trên thị trường. Lọc các sự kiện tổ chức thành "Đã có thể tải về." Chỉ xuất bản hoặc cập nhật danh sách sau khi PhotoRobot thực sự có thể phục vụ hình ảnh.
- Khả năng hiển thị trên bo mạch sản xuất. Đăng ký item.status.changed khi ERP hoặc bo mạch QC của bạn cần biết một mục đã được chuyển sang CHỈNH SỬA, PHÊ DUYỆT hoặc XUẤT BẢN — ngay cả trước khi máy chủ sẵn sàng.
- Cập nhật chiến dịch hàng loạt. Sau một thay đổi trạng thái lớn trên Cloud, một sự kiện item.status.bulk_changed sẽ đến cùng với một deltaUrl. Bắt kịp bộ dữ liệu bị ảnh hưởng thay vì mong đợi hàng nghìn webhook cho mỗi mục.
- Vô hiệu hóa bộ nhớ đệm hoặc CDN. Khi dịch vụ lưu trữ chuyển sang khả dụng hoặc không khả dụng, hãy xóa hoặc làm nóng các đường dẫn mà cửa hàng của bạn đã biết. Webhook là kích hoạt; API lưu trữ là nguồn của các URL mới.
Cách cấu hình Webhook cho khách hàng của bạn
Để thiết lập Web hook Khách hàng cho PhotoRobot Cloud, mở Tài khoản PhotoRobot của bạn ở chế độ Nhà phát triển và sử dụng Webhooks để tạo đăng ký webhook. Sau đó, trỏ đăng ký đến điểm cuối staging của bạn để xác minh lần giao hàng đầu tiên.
- Đăng nhập vào Tài khoản PhotoRobot và mở Developers → Webhooks.
- Tạo một webhook. Dán endpoint HTTPS của bạn, đặt tên nội bộ, và chọn các sự kiện bạn cần.
- Sao chép bí mật ký khi nó xuất hiện — nó được hiển thị một lần cho đến khi bạn xoay nó.
- Nhấp vào Gửi test. Xác nhận webhook.subscription.test đã đến và chữ ký được xác minh.
- Mở nhật ký Giao hàng để kiểm tra payload, trạng thái HTTP và các lần thử lại.
- Trỏ đăng ký đầu tiên đến điểm cuối staging.
Để biết thêm thông tin kỹ thuật bao gồm các ví dụ hợp đồng và chữ ký của nhà phát triển, hãy tham khảo PhotoRobot Developer Portal – Webhooks.
