Memperkenalkan: Webhook Pelanggan untuk PhotoRobot Cloud

Webhook Pelanggan untuk PhotoRobot Cloud

Pengembang dan tim TI Anda kini dapat menghubungkan PhotoRobot Cloud ke DAM, PIM, ERP, atau otomasi khusus dengan webhook keluar yang ditandatangani. Webhook pelanggan di PhotoRobot Cloud menawarkan pengiriman data yang andal dan berbasis peristiwa – memastikan konektivitas penuh antara studio dan sistem Anda.

‍

‍

‍

Tutup Lingkaran Antara Studio Anda dan Sistem Anda

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

Acara langsung adalah:

• Status.Item.Changed – Perubahan status penangkapan yang dikomitmenkan pada satu item.
• item.status.bulk_changed — satu peristiwa setelah perubahan status massal Cloud.
• hosting.item.availability.changed — media yang dihosting menjadi dapat diunduh atau tidak tersedia.
• webhook.subscription.test — Hanya kirim tes.

‍

‍

‍

Pengiriman Data yang Andal dan Berbasis Peristiwa

Webhook pelanggan di PhotoRobot Cloud mencakup fitur untuk:

• Langganan Webhook keluar dikelola bersama integrasi pengembang Anda.
• Pengiriman HTTP yang ditandatangani agar penerima dapat memverifikasi keaslian.
• "Kirim tes" dan filter untuk mengonfirmasi langganan webhook dan verifikasi tanda tangan.
• Log pengiriman untuk memeriksa payload, status HTTP, dan retries.
• Antarmuka pengembang di bawah Webhooks — webhook dan pengiriman berada di samping kunci API.

‍

‍

‍

Berbicara dalam Bahasa Anda untuk Integrasi Produksi

Webhook pelanggan adalah tautan yang hilang antara penangkapan robotisasi dan sistem pencatatan perusahaan. Webhook adalah sinyal bertanda, yang hanya membawa payload kecil dengan sengaja. Setelah 2xx, integrasi menarik item saat ini dari REST v2 (pull.itemUrl / pull.deltaUrl). Webhook dapat memberi tahu penerbit, atau, setelah penarikan, membantu tim Anda memulai pembersihan CDN atau memperbarui daftar marketplace. PhotoRobot Cloud kini berbicara dalam bahasa Anda untuk integrasi produksi.

‍

‍

‍

Sebuah Sinyal, lalu Tarikan

Payload sengaja tetap kecil. Setiap payload menamai event, organisasi, dan (jika relevan) item, plus pull.itemUrl dan pull.deltaUrl. Payload tidak membawa biner gambar, pohon folder penuh, atau catatan produk lengkap.

Pola yang harus diterapkan oleh pengembang adalah:

1. Terima POST dan verifikasi X-PhotoRobot-Signature terhadap bodi mentah.
2. Kembalikan 2xx dengan cepat — lakukan impor DAM atau pembaruan marketplace pada pekerja Anda sendiri.
3. Deduplikasi berdasarkan event ID. Pengiriman minimal sekali.
4. Ambil status saat ini dari hosting REST v2 menggunakan URL pull.

Pembagian itulah yang membuat integrasi dapat diandalkan. PhotoRobot tidak menunggu pekerjaan katalog Anda selesai, dan sistem Anda tidak pernah menganggap notifikasi sebagai katalog.

‍

‍

‍

Contoh Umum Webhook Pelanggan yang Digunakan

Kasus penggunaan paling umum untuk Customer Webhook dalam ekosistem PhotoRobot meliputi:

• Refresh PIM atau DAM. Berlangganan hosting.item.availability.changed. Saat media yang dihosting dapat diunduh, tarik itemUrl dan perbarui produk — spin, stills, dan metadata dalam satu proses.
• Daftar marketplace. Saring acara hosting menjadi "Menjadi dapat diunduh." Publikasikan atau perbarui listing hanya setelah PhotoRobot benar-benar dapat menampilkan gambar.
• Visibilitas papan produksi. Berlangganan item.status.changed ketika papan ERP atau QC Anda perlu mengetahui bahwa sebuah item dipindahkan ke EDITED, APPROVED, atau PUBLISHED — bahkan sebelum hosting siap.
• Pembaruan kampanye massal. Setelah perubahan status besar di Cloud, satu event item.status.bulk_changed tiba dengan deltaURL. Kejar set yang terdampak daripada mengharapkan ribuan webhook per item.
• Invalidasi cache atau CDN. Saat hosting beralih ke tersedia atau tidak tersedia, hapus atau hangatkan jalur yang sudah diketahui toko Anda. Webhook adalah pemicu; API hosting adalah sumber URL baru.

‍

‍

‍

Cara Mengonfigurasi Webhook Pelanggan Anda

Untuk mengatur Customer Webhooks untuk PhotoRobot Cloud, buka Akun PhotoRobot Anda dalam mode Pengembang dan gunakan Webhooks untuk membuat langganan webhook. Kemudian, arahkan langganan ke titik akhir staging Anda untuk memverifikasi pengiriman pertama.

‍

‍

1. Masuk ke Akun PhotoRobot dan buka Developers → Webhooks.
2. Buat webhook. Tempel endpoint HTTPS Anda, berikan nama internal, dan pilih event yang Anda butuhkan.
3. Salin rahasia penandatanganan saat muncul — akan ditampilkan sekali sampai Anda memutarnya.
4. Klik Kirim tes. Konfirmasi webhook.subscription.test tiba dan tanda tangan terverifikasi.
5. Buka log Pengiriman untuk memeriksa payload, status HTTP, dan retry.
6. Arahkan langganan pertama ke titik akhir staging.

‍

‍

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

‍

‍