Yeni: PhotoRobot Cloud için Customer Webhooks

PhotoRobot Cloud için Customer Webhooks

Geliştiricileriniz ve BT ekipleriniz artık PhotoRobot Cloud çözümünü DAM, PIM, ERP veya özel otomasyon sistemlerinize imzalı giden webhook'lar aracılığıyla bağlayabilir. PhotoRobot Cloud'daki Customer Webhooks, güvenilir ve olay tabanlı veri iletimi sunar; böylece stüdyonuz ile sistemleriniz arasında tam bağlantı sağlanır.

‍

‍

‍

Stüdyonuz ile Sistemleriniz Arasındaki Döngüyü Tamamlayın

Bir öğenin durumu değiştiğinde veya bir barındırma erişilebilirliği olayı gerçekleştiğinde alt akış sistemlerinizin bundan haberdar olmasını sağlayın. PhotoRobot Cloud Customer Webhooks, her olayı uç noktalarınıza ileterek entegrasyonlarınızın yoklama (polling) tabanlı değil, olay tabanlı kalmasını sağlar.

Canlı olaylar şunlardır:

• item.status.changed – tek bir öğede onaylanmış çekim durumu değişikliği.
• item.status.bulk_changed — Cloud'da toplu durum değişikliğinin ardından gönderilen tek bir olay.
• hosting.item.availability.changed — barındırılan medya indirilebilir hale geldi veya kullanılamaz oldu.
• webhook.subscription.test — yalnızca “Send test” için.

‍

‍

‍

Güvenilir, Olay Tabanlı Veri İletimi

PhotoRobot Cloud'daki Customer Webhooks, aşağıdaki alanlara yönelik özellikler içerir:

• Geliştirici entegrasyonlarınızla birlikte yönetilen giden webhook abonelikleri.
• Alıcıların orijinalliği doğrulayabilmesi için imzalı HTTP iletimi.
• Webhook aboneliğini ve imza doğrulamasını onaylamak için “Send test” ve filtreler.
• Payload'u, HTTP durumunu ve yeniden denemeleri incelemek için iletim günlüğü.
• Webhooks altında geliştirici arayüzü — webhook'lar ve iletimler API anahtarlarının yanında yer alır.

‍

‍

‍

Üretim Entegrasyonlarında Sizin Dilinizi Konuşmak

Customer Webhooks, robotik çekim ile kurumsal kayıt sistemleri arasındaki eksik halkadır. Webhook, bilinçli olarak yalnızca küçük yükler (payload) taşıyan imzalı bir sinyaldir. 2xx yanıtından sonra entegrasyon, güncel öğeyi REST v2 üzerinden (pull.itemUrl / pull.deltaUrl) çeker. Webhook'lar bir yayıncıyı bilgilendirebilir veya çekme işleminin ardından ekibinizin bir CDN temizleme (purge) işlemi başlatmasına ya da bir pazar yeri listesini güncellemesine yardımcı olabilir. PhotoRobot Cloud artık üretim entegrasyonlarında sizin dilinizi konuşuyor.

‍

‍

‍

Önce Sinyal, Sonra Çekme

Payload'lar bilinçli olarak küçük tutulur. Her payload; olayı, kuruluşu ve (ilgili olduğunda) öğeyi belirtir, ayrıca pull.itemUrl ve pull.deltaUrl değerlerini içerir. Payload'lar görsel ikili dosyalarını, tam klasör yapılarını veya eksiksiz bir ürün kaydını taşımaz.

Geliştiricilerin uygulaması gereken desen şöyledir:

1. POST isteğini alın ve X-PhotoRobot-Signature değerini ham gövde (raw body) üzerinden doğrulayın.
2. Hızlıca 2xx döndürün — DAM içe aktarma veya pazaryeri güncelleme işlemini kendi worker'ınızda yapın.
3. Olay kimliğine (event ID) göre mükerrer kayıtları ayıklayın. İletim en az bir kez (at-least-once) gerçekleşir.
4. Pull URL'lerini kullanarak güncel durumu REST v2 hosting'den çekin.

Entegrasyonu güvenilir kılan şey bu ayrımdır. PhotoRobot, katalog işinizin tamamlanmasını beklemez; sisteminiz de bir bildirimi hiçbir zaman kataloğun kendisi olarak ele almaz.

‍

‍

‍

Customer Webhooks’un Yaygın Kullanım Örnekleri

PhotoRobot ekosisteminde Customer Webhooks için en yaygın kullanım senaryoları şunlardır:

• PIM veya DAM güncellemesi. hosting.item.availability.changed olayına abone olun. Barındırılan medya indirilebilir hale geldiğinde itemUrl adresini çekin ve ürünü güncelleyin; spin görsellerini, statik görselleri ve metaverileri tek seferde aktarın.
• Pazaryeri listelemesi. Hosting olaylarını “Became downloadable” olayına göre filtreleyin. Listelemeyi yalnızca PhotoRobot görselleri gerçekten sunabildiğinde yayınlayın veya güncelleyin.
• Üretim panosu görünürlüğü. ERP veya QC panonuzun bir öğenin EDITED, APPROVED ya da PUBLISHED durumuna geçtiğini bilmesi gerektiğinde item.status.changed olayına abone olun; bu, hosting hazır olmadan önce bile mümkündür.
• Toplu kampanya güncellemeleri. Cloud’da büyük bir durum değişikliğinden sonra deltaUrl içeren tek bir item.status.bulk_changed olayı gelir. Binlerce öğe bazlı webhook beklemek yerine etkilenen kümeyi tek seferde senkronize edin.
• Önbellek veya CDN geçersiz kılma. Hosting kullanılabilir ya da kullanılamaz duruma geçtiğinde, mağazanızın zaten bildiği yolları temizleyin veya önceden ısıtın. Webhook tetikleyicidir; yeni URL’lerin kaynağı ise Hosting API’dir.

‍

‍

‍

Customer Webhooks Nasıl Yapılandırılır

PhotoRobot Cloud için Customer Webhooks'u kurmak üzere PhotoRobot Account hesabınızı Developers modunda açın ve bir webhook aboneliği oluşturmak için Webhooks bölümünü kullanın. Ardından, ilk iletimi doğrulamak için aboneliği staging uç noktanıza yönlendirin.

‍

‍

1. PhotoRobot Account'ta oturum açın ve Developers → Webhooks bölümünü açın.
2. Bir webhook oluşturun. HTTPS uç noktanızı yapıştırın, ona dahili bir ad verin ve ihtiyacınız olan olayları seçin.
3. İmza anahtarı göründüğünde kopyalayın; anahtarı yenileyene kadar yalnızca bir kez gösterilir.
4. Send test düğmesine tıklayın. webhook.subscription.test olayının ulaştığını ve imzanın doğrulandığını kontrol edin.
5. Payload’ı, HTTP durumunu ve yeniden denemeleri incelemek için Delivery log bölümünü açın.
6. İlk aboneliği bir staging uç noktasına yönlendirin.

‍

‍

Geliştirici sözleşmesi ve imza örnekleri dahil daha fazla teknik bilgi için PhotoRobot Developer Portal – Webhooks sayfasına bakın.

‍

‍