Perkenalan: Customer Webhooks untuk PhotoRobot Cloud

Customer Webhooks untuk PhotoRobot Cloud

Developer dan tim IT Anda kini dapat menghubungkan PhotoRobot Cloud ke DAM, PIM, ERP, atau otomatisasi kustom Anda melalui webhook keluar yang bertanda tangan. Customer webhooks di PhotoRobot Cloud menghadirkan pengiriman data berbasis peristiwa yang andal – memastikan konektivitas penuh antara studio dan sistem Anda.

‍

‍

‍

Tutup Celah antara Studio dan Sistem Anda

Pastikan sistem hilir Anda mengetahui saat status item berubah atau terjadi peristiwa ketersediaan hosting. PhotoRobot Cloud Customer Webhooks mengirimkan setiap peristiwa ke endpoint Anda sehingga integrasi tetap berbasis peristiwa – bukan berbasis polling.

Peristiwa yang aktif saat ini:

• item.status.changed – perubahan status pengambilan gambar yang telah di-commit pada satu item.
• item.status.bulk_changed — satu peristiwa setelah perubahan status massal di Cloud.
• hosting.item.availability.changed — media yang di-hosting menjadi dapat diunduh atau tidak tersedia.
• webhook.subscription.test — hanya untuk Send test.

‍

‍

‍

Pengiriman Data Berbasis Peristiwa yang Andal

Customer Webhooks di PhotoRobot Cloud mencakup fitur untuk:

• Langganan webhook keluar yang dikelola bersama integrasi developer Anda.
• Pengiriman HTTP bertanda tangan agar penerima dapat memverifikasi keaslian.
• “Send test” dan filter untuk mengonfirmasi langganan webhook dan verifikasi tanda tangan.
• Log pengiriman untuk memeriksa payload, status HTTP, dan percobaan ulang.
• Antarmuka developer di bawah Webhooks — webhook dan pengiriman berada di samping kunci API.

‍

‍

‍

Berbicara dalam Bahasa Anda untuk Integrasi Produksi

Customer Webhooks adalah mata rantai yang selama ini hilang antara pengambilan gambar robotik dan sistem pencatatan perusahaan. Webhook adalah sinyal bertanda tangan yang sengaja hanya membawa payload kecil. Setelah menerima 2xx, integrasi mengambil item terkini dari REST v2 (pull.itemUrl / pull.deltaUrl). Webhook dapat memberi tahu publisher atau, setelah pull, membantu tim Anda memulai pembersihan CDN (purge) atau memperbarui listing marketplace. PhotoRobot Cloud kini berbicara dalam bahasa Anda untuk integrasi produksi.

‍

‍

‍

Sinyal, Lalu Pull

Payload sengaja dibuat tetap kecil. Setiap payload menyebutkan peristiwa, organisasi, dan (bila relevan) item, beserta pull.itemUrl dan pull.deltaUrl. Payload tidak membawa file biner gambar, struktur folder lengkap, atau catatan produk yang utuh.

Pola yang sebaiknya diterapkan developer adalah:

1. Terima POST dan verifikasi X-PhotoRobot-Signature terhadap raw body.
2. Kembalikan 2xx dengan cepat — lakukan impor DAM atau pembaruan marketplace di worker Anda sendiri.
3. Lakukan deduplikasi berdasarkan ID peristiwa. Pengiriman bersifat at-least-once.
4. Ambil status terkini dari hosting REST v2 menggunakan URL pull.

Pemisahan inilah yang membuat integrasi andal. PhotoRobot tidak menunggu proses katalog Anda selesai, dan sistem Anda tidak pernah menganggap notifikasi sebagai katalog itu sendiri.

‍

‍

‍

Contoh Umum Penggunaan Customer Webhooks

Kasus penggunaan Customer Webhooks yang paling umum di ekosistem PhotoRobot meliputi:

• Pembaruan PIM atau DAM. Berlangganan hosting.item.availability.changed. Saat media yang di-hosting sudah dapat diunduh, ambil itemUrl lalu perbarui produk — spin, foto diam, dan metadata sekaligus dalam satu proses.
• Listing marketplace. Filter event hosting ke “Became downloadable.” Publikasikan atau perbarui listing hanya setelah PhotoRobot benar-benar dapat menyajikan gambarnya.
• Visibilitas papan produksi. Berlangganan item.status.changed saat ERP atau papan QC Anda perlu mengetahui bahwa suatu item telah berpindah ke EDITED, APPROVED, atau PUBLISHED — bahkan sebelum hosting siap.
• Pembaruan kampanye massal. Setelah perubahan status dalam jumlah besar di Cloud, satu event item.status.bulk_changed akan masuk beserta deltaUrl. Sinkronkan sekumpulan item yang terdampak, alih-alih mengharapkan ribuan webhook per item.
• Invalidasi cache atau CDN. Saat hosting beralih ke tersedia atau tidak tersedia, bersihkan (purge) atau panaskan (warm) path yang sudah dikenal storefront Anda. Webhook berfungsi sebagai pemicu; Hosting API adalah sumber URL yang baru.

‍

‍

‍

Cara Mengonfigurasi Customer Webhooks Anda

Untuk menyiapkan Customer Webhooks bagi PhotoRobot Cloud, buka PhotoRobot Account Anda dalam mode Developers, lalu gunakan Webhooks untuk membuat langganan webhook. Setelah itu, arahkan langganan tersebut ke endpoint staging Anda untuk memverifikasi pengiriman pertama.

‍

‍

1. Masuk ke PhotoRobot Account dan buka Developers → Webhooks.
2. Buat webhook. Tempelkan endpoint HTTPS Anda, beri nama internal, lalu pilih event yang Anda butuhkan.
3. Salin signing secret saat ditampilkan — secret ini hanya ditampilkan sekali hingga Anda merotasinya.
4. Klik Send test. Pastikan webhook.subscription.test diterima dan tanda tangan berhasil diverifikasi.
5. Buka Delivery log untuk memeriksa payload, status HTTP, dan percobaan ulang.
6. Arahkan langganan pertama ke endpoint staging.

‍

‍

Untuk informasi teknis lebih lanjut, termasuk kontrak developer dan contoh tanda tangan, lihat PhotoRobot Developer Portal – Webhooks.

‍

‍