Giới thiệu: Customer Webhooks cho PhotoRobot Cloud

Customer Webhooks cho PhotoRobot Cloud

Đội ngũ lập trình viên và IT của bạn nay có thể kết nối PhotoRobot Cloud với DAM, PIM, ERP hoặc quy trình tự động hóa tùy chỉnh thông qua các webhook chiều đi có chữ ký. Customer Webhooks trong PhotoRobot Cloud cung cấp phương thức truyền dữ liệu theo sự kiện, đáng tin cậy – đảm bảo kết nối toàn diện giữa studio và các hệ thống của bạn.

‍

‍

‍

Khép kín vòng lặp giữa studio và hệ thống của bạn

Đảm bảo các hệ thống phía sau luôn nắm được khi trạng thái của một mục thay đổi hoặc khi xảy ra sự kiện về tình trạng khả dụng của hosting. PhotoRobot Cloud Customer Webhooks gửi từng sự kiện đến các endpoint của bạn, để các tích hợp vận hành theo sự kiện – thay vì dựa trên polling.

Các sự kiện hiện có:

• item.status.changed – thay đổi trạng thái chụp đã được ghi nhận đối với một mục.
• item.status.bulk_changed — một sự kiện duy nhất sau khi thay đổi trạng thái hàng loạt trong Cloud.
• hosting.item.availability.changed — tệp media được lưu trữ có thể tải xuống hoặc không còn khả dụng.
• webhook.subscription.test — chỉ dùng cho “Send test”.

‍

‍

‍

Truyền dữ liệu theo sự kiện, đáng tin cậy

Customer Webhooks trong PhotoRobot Cloud bao gồm các tính năng cho:

• Đăng ký webhook gửi đi, được quản lý cùng với các tích hợp dành cho lập trình viên của bạn.
• Gửi qua HTTP có chữ ký để bên nhận có thể xác minh tính xác thực.
• “Send test” và bộ lọc để xác nhận đăng ký webhook và việc xác minh chữ ký.
• Nhật ký gửi để kiểm tra payload, trạng thái HTTP và các lần thử lại.
• Giao diện dành cho lập trình viên trong mục Webhooks — webhook và các lần gửi nằm cạnh khóa API.

‍

‍

‍

Nói cùng ngôn ngữ với các tích hợp production của bạn

Customer Webhooks là mắt xích còn thiếu giữa quá trình chụp bằng robot và các hệ thống quản lý dữ liệu gốc của doanh nghiệp. Webhook là một tín hiệu có chữ ký, chủ ý chỉ mang payload nhỏ. Sau phản hồi 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 một publisher hoặc, sau khi lấy dữ liệu, hỗ trợ đội ngũ của bạn kích hoạt thao tác xóa bộ nhớ đệm CDN (CDN purge) hoặc cập nhật tin đăng trên sàn thương mại điện tử. PhotoRobot Cloud nay đã “nói cùng ngôn ngữ” với các tích hợp production của bạn.

‍

‍

‍

Một tín hiệu, rồi đến một lần pull

Payload chủ ý được giữ ở dung lượng nhỏ. Mỗi payload nêu rõ sự kiện, tổ chức và (khi liên quan) mục, cùng với pull.itemUrl và pull.deltaUrl. Payload không chứa tệp nhị phân của hình ảnh, toàn bộ cây thư mục hay bản ghi sản phẩm đầy đủ.

Quy trình mà lập trình viên nên triển khai như sau:

1. Nhận yêu cầu POST và xác minh X-PhotoRobot-Signature dựa trên phần body gốc (raw body).
2. Trả về mã 2xx nhanh chóng — thực hiện việc nhập vào DAM hoặc cập nhật marketplace trong worker của riêng bạn.
3. Loại bỏ trùng lặp theo event ID. Cơ chế gửi là at-least-once.
4. Lấy trạng thái hiện tại từ REST v2 hosting bằng các URL pull.

Chính sự tách biệt này giúp tích hợp hoạt động ổn định. PhotoRobot không chờ tác vụ danh mục (catalog) của bạn hoàn tất, và hệ thống của bạn không bao giờ coi một thông báo là chính danh mục đó.

‍

‍

‍

Các ví dụ phổ biến khi sử dụng Customer Webhooks

Các trường hợp sử dụng phổ biến nhất của Customer Webhooks trong hệ sinh thái PhotoRobot bao gồm:

• Làm mới PIM hoặc DAM. Đăng ký sự kiện hosting.item.availability.changed. Khi nội dung media được lưu trữ có thể tải xuống, hãy lấy itemUrl và cập nhật sản phẩm – ảnh xoay, ảnh tĩnh và metadata trong một lần xử lý.
• Đăng sản phẩm lên marketplace. Lọc các sự kiện hosting theo “Became downloadable”. Chỉ đăng hoặc cập nhật sản phẩm sau khi PhotoRobot thực sự có thể cung cấp hình ảnh.
• Theo dõi tiến độ sản xuất. Đăng ký item.status.changed khi hệ thống ERP hoặc bảng QC của bạn cần biết một mục đã chuyển sang trạng thái EDITED, APPROVED hoặc PUBLISHED – ngay cả trước khi hosting sẵn sàng.
• Cập nhật hàng loạt theo chiến dịch. Sau một thay đổi trạng thái quy mô lớn trong Cloud, một sự kiện item.status.bulk_changed kèm deltaUrl sẽ được gửi đến. Hãy cập nhật tập hợp mục bị ảnh hưởng thay vì chờ hàng nghìn webhook riêng lẻ cho từng mục.
• Vô hiệu hóa cache hoặc CDN. Khi hosting chuyển sang trạng thái khả dụng hoặc không khả dụng, hãy xóa (purge) hoặc làm nóng (warm) các đường dẫn mà storefront của bạn đã biết. Webhook là tác nhân kích hoạt; Hosting API là nguồn cung cấp các URL mới.

‍

‍

‍

Cách cấu hình Customer Webhooks của bạn

Để thiết lập Customer Webhooks cho PhotoRobot Cloud, hãy mở PhotoRobot Account của bạn ở chế độ Developers và dùng mục Webhooks để tạo một subscription webhook. Sau đó, trỏ subscription đến endpoint staging của bạn để xác minh lần gửi đầu tiên.

‍

‍

1. Đăng nhập vào PhotoRobot Account và mở Developers → Webhooks.
2. Tạo một webhook. Dán endpoint HTTPS của bạn, đặt tên nội bộ cho webhook và chọn các sự kiện bạn cần.
3. Sao chép signing secret khi nó xuất hiện – khóa này chỉ hiển thị một lần cho đến khi bạn xoay khóa (rotate).
4. Nhấp Send test. Xác nhận webhook.subscription.test được gửi đến và chữ ký được xác thực thành công.
5. Mở Delivery log để kiểm tra payload, trạng thái HTTP và các lần thử lại.
6. Trỏ subscription đầu tiên tới một endpoint staging.

‍

‍

Để biết thêm thông tin kỹ thuật, bao gồm hợp đồng dành cho lập trình viên (developer contract) và ví dụ về chữ ký, vui lòng tham khảo PhotoRobot Developer Portal – Webhooks.

‍

‍