Tanıtım: PhotoRobot Cloud için Müşteri Webhookları

PhotoRobot Cloud için müşteri web kancaları

Geliştiricileriniz ve BT ekipleriniz artık PhotoRobot Cloud'u DAM, PIM, ERP veya özel otomasyonunuza imzalı giden web hook'larla bağlayabilir. PhotoRobot Cloud'daki müşteri web hookları, stüdyonuz ile sistemler arasında tam bağlantı sağlayarak güvenilir, olay odaklı veri teslimatı sunar.

‍

‍

‍

Stüdyonun ile Sistemler Arasındaki Döngüyü Kapat

Aşağı akış sistemlerinizin, bir öğe durumu değiştiğinde veya barındırma erişilebilirliği olayı gerçekleştiğinde bildiğinden emin olun. PhotoRobot Cloud Müşteri Webhookları, her olayı uç noktalarınıza ulaştırarak entegrasyonların anket tabanlı değil, olay odaklı kalmasını sağlar.

Canlı etkinlikler şunlardır:

• item.status.changed – bir öğede capture-status değişikliği yapıldı.
• item.status.bulk_changed — Cloud toplu durum değişikliğinden sonraki bir olay.
• hosting.item.availability.changed — barındırılan medya indirilebilir veya erişilmez hale geldi.
• webhook.subscription.test — Sadece testi gönderin.

‍

‍

‍

Güvenilir, Olay Odaklı Veri Teslimatı

PhotoRobot Cloud'daki müşteri web kancaları şunları içeren özellikleri içerir:

• Giden webhook abonelikleri, geliştirici entegrasyonlarınızla birlikte yönetilir.
• Alıcıların gerçekliği doğrulayabilmesi için imzalı HTTP teslimatı .
• "Test gönder" ve webhook aboneliği ile imza doğrulamasını doğrulamak için filtreler.
• Yükü, HTTP durumunu ve denemeleri incelemek için teslimat günlüğü.
• Webhooks altında geliştirici arayüzü — web hook'lar ve teslimatlar API anahtarlarının yanında yaşar.

‍

‍

‍

Prodüksiyon Entegrasyonları İçin Kendi Dilinizi Konuşmak

Müşteri Webhook'ları, robotize yakalama ile şirket kayıt sistemleri arasındaki eksik halkadır. Webhook, yalnızca küçük yükleri kasıtlı olarak taşıyan işaretli bir sinyaldir. 2xx sonrası, entegrasyon mevcut öğeyi REST v2'den (pull.itemUrl / pull.deltaUrl) çeker. Webhooklar, bir yayıncını bilgilendirebilir veya çekimden sonra ekibinize CDN temizleme başlatma veya pazar yeri listesini güncelleme konusunda yardımcı olabilir. PhotoRobot Cloud artık üretim entegrasyonları için sizin dilinizi konuşuyor.

‍

‍

‍

Bir Sinyal, sonra bir Çekim

Yükler kasıtlı olarak küçük kalır. Her yük, olayı, organizasyonu ve (ilgili olduğunda) öğeyi adlandırır, ayrıca pull.itemUrl ve pull.deltaUrl'i kullanır. Yükler görüntü ikili kartları, tam klasör ağaçları veya tam ürün kaydı taşımaz .

Geliştiricilerin uygulaması gereken model şudur:

1. POST'u alın ve X-PhotoRobot-Signature'ı ham gövdeye karşı doğrulayın.
2. 2xx hızlıca geri dönün — DAM ithalatını veya pazar güncellemesini kendi çalışanınızda yapın.
3. Etkinlik kimliğine göre deduplicate. Teslimat en az bir kez yapılır.
4. REST v2 barındırma sisteminden pull URL'leri kullanarak mevcut durumu getirin.

Bu bölünme entegrasyonu güvenilir kılan şeydir. PhotoRobot katalog işinizin bitmesini beklemez ve sisteminiz asla bildirimi katalog olarak kabul etmez.

‍

‍

‍

Kullanıcı Web Kancalarının Yaygın Örnekleri

PhotoRobot ekosisteminde Müşteri Webhook'larının en yaygın kullanım durumları şunlardır:

• PIM veya DAM yenilemesi. hosting.item.availability.changed'e abone olun. Barındırılan medya indirilebilir hale geldiğinde, itemUrl'i çekip ürünü — dönmeleri, fotoğrafları ve meta verileri tek geçişte — güncelleyin.
• Pazar yeri listesi. Etkinlikleri "İndirilebilir hale geldi" olarak filtreleyin. Ilanı, PhotoRobot görselleri gerçekten sunabildikten sonra yayınlayın veya güncelledin.
• Üretim kurulu görünürlüğü. ERP veya QC kurulunuzun bir öğenin DÜZENLENDİ, ONAYLANDI veya YAYIMLANDIĞINA taşındığını bilmesi gerektiğinde — barındırma hazır olmadan önce — item.status.changed'a abone olun.
• Toplu kampanya güncellemeleri. Bulut'ta büyük bir durum değişikliğinden sonra, bir item.status.bulk_changed olay deltaUrl ile geliyor. Etkilenen seti takip edin, her öğe başına binlerce web kancası beklemek yerine.
• Önbellek veya CDN geçersiz hale gelme. Barındırma mevcut veya kullanılamaz hale geldiğinde, mağazanızın zaten bildiği yolları temizleyin veya ısıtın. Webhook tetikleyicidir; Hosting API'si yeni URL'lerin kaynağıdır.

‍

‍

‍

Müşteri Webhooklarınızı Nasıl Yapılandırmalısınız

PhotoRobot Cloud için Müşteri Webhook'larını kurmak için, Geliştiriciler modunda PhotoRobot Hesabınızı açın ve Webhooks kullanarak bir webhook aboneliği oluşturun. Sonra, aboneliği aşama noktanıza yönlendirerek ilk teslimatı doğrulayın.

‍

‍

1. PhotoRobot Hesabına giriş yapın ve Developers → Webhooks'u açın.
2. Bir web kancası oluşturun. HTTPS uç noktanızı yapıştırın, ona dahili bir isim verin ve ihtiyacınız olan olayları seçin.
3. İmza sırrını göründüğünde kopyalayın — bir kez gösteriliyor, ta ki döndürene kadar.
4. Testi gönder seçeneğine tıklayın. webhook.subscription.test'in geldiğini ve imzanın doğrulandığını onaylayın.
5. Yük, HTTP durumu ve denemeleri incelemek için Teslimat logunu açın.
6. İlk aboneliği bir aşama uç noktasına yönlendirin.

‍

‍

Geliştirici sözleşmesi ve imza örnekleri dahil olmak üzere daha fazla teknik bilgi için PhotoRobot Geliştirici Portalı – Webhooks sayfasına bakabilirsiniz.

‍

‍