Ajanlarınız çalışıyor, kartlar ilerliyor, koleksiyonlara kayıt düşüyor ve bunların hepsi panoda duruyor.
Ama şirketinizde ondan başka sistemler de var. CRM'iniz yeni bir müşteri talebini bilmek istiyor, muhasebe yazılımınız kapanan bir işi duymak istiyor, kendi yazdığınız küçük bir servis bir raporun hazır olduğunu öğrenmek istiyor.
Her birine ayrı ayrı bakmak yerine, olan biteni onlara haber vermek mümkün.
Giden bağlantı ne yapar
Bir giden bağlantı, Orbi'de bir şey olduğunda sizin belirlediğiniz bir adrese haber gönderir. Kart açıldığında, koleksiyona kayıt yazıldığında ya da bir koşu bittiğinde kendi sisteminiz bunu anında öğrenir ve kendi işini yapar.
Bu, dışarıya doğru olan yön. Tersi de var, yani dışarıdan gelen bir olayın Orbi'de bir akışı başlatması, ama o ayrı bir mekanizma.
Yirmi altı olay
Abone olabileceğiniz olaylar altı öbekte toplanıyor.
Kartlar tarafında kart açılması, durum değişmesi, atama, güncelleme, silme, yorum, kontrol listesi adımı ve ek dosya var. Koleksiyonlarda kayıt oluşturma, güncelleme ve silme. Dosyalarda dosya oluşturma ve yeni sürüm. Koşularda görev ve akış koşularının başlaması ile bitmesi. Üyelikte katılma, ayrılma ve rol değişikliği. Kredi tarafında da kredinin azalması ve tükenmesi.
Listeden istediğiniz kadarını seçersiniz. Hepsine abone olmak ilk bakışta güvenli görünür ama alıcı tarafta işlemeyeceğiniz olayları ayıklamak zorunda kalırsınız.
Dört olay eski adlarıyla listede durmaya devam ediyor. Bunlar ilk sürümden kalma adlar ve çalışmayı sürdürüyorlar, çünkü kurulmuş bir entegrasyon bizim adlandırmamız değişti diye susmamalı.
Daraltmak gönderdiğinizden daha önemli
Bağlantıyı eklerken üç şey belirliyorsunuz. Adres, olaylar ve daraltma.
Daraltma isteğe bağlı ama en çok işe yarayan kısım. Yalnız belirli projelerin kartlarını, yalnız belirli koleksiyonların kayıtlarını ya da yalnız insanların veya yalnız ajanların yaptığı değişiklikleri gönderebilirsiniz.
Son seçenek düşündüğünüzden daha kullanışlı. "Yalnız ajanların yazdıkları" filtresi, otomatik üretilen kayıtları kendi sisteminize akıtırken insan girişlerini dışarıda bırakıyor. Ya da tersi, yalnız insan hareketlerini dinleyip ajanların gürültüsünü almıyorsunuz.
Hiçbir kutu işaretlenmezse hepsi gönderilir.
İsteğin gerçekten Orbi'den geldiğini doğrulamak
Kaydettiğiniz anda bir token gösteriliyor ve bir daha gösterilmiyor. Kaydedin, çünkü doğrulamayı onunla yapacaksınız.
Her istek bir imza taşıyor ve imza, token ile zaman damgası ile gövdenin birleşimi üzerinden üretiliyor. Alıcı tarafta aynı hesabı yapıp karşılaştırıyorsunuz.
Gövdeyi ham hâliyle imzalayın, çünkü JSON'a çevrilip yeniden metne dönen bir gövdede alan sırası ve boşluklar değişir ve imza tutmaz. İkincisi zaman damgası çok eskiyse isteği reddedin, yoksa kaydedilmiş eski bir istek size tekrar gönderilebilir.
Başlıklarda taşınan bir alanı da kullanmak zorundasınız. Olayın kimliği aynı olayı iki kez işlememenizi sağlıyor. Bir teslimat yeniden gönderildiğinde olay kimliği değişmiyor, yani alıcı tarafta tekilleştirme çalışmaya devam ediyor.
Token'ı değiştirmek işi durdurmuyor
Token'ı döndürdüğünüzde eski token yirmi dört saat daha geçerli kalıyor ve bu süre boyunca her istek iki imzayla geliyor.
Küçük bir ayrıntı gibi duruyor ve aslında bir sabahı kurtarıyor. Alıcı sisteminizi acele etmeden güncelliyorsunuz, arada hiçbir olay düşmüyor.
Teslimat günlüğü
Uca tıkladığınızda paneli açılıyor ve orada abone olunan olaylar, teslimat günlüğü ve bütün eylemler duruyor.
Günlük son teslimatları gösteriyor. Durum, kaçıncı deneme, alıcının döndürdüğü kod ve isteğin ne kadar sürdüğü satırda yazıyor. Ayrıntıya bastığınızda gönderilen gövdeyi ve alıcının yanıtını olduğu gibi görüyorsunuz.
"Neden gitmedi" sorusunun cevabı çoğu zaman burada duruyor. Bir entegrasyon kurarken en çok zaman kaybettiren şey, isteğin gidip gitmediğini bilmemek.
Başarısız olan kaybolmuyor
Alıcı iki yüzlü bir kod dönmezse istek üç kez daha deneniyor. Bir dakika, beş dakika ve otuz dakika sonra.
Hepsi başarısız olursa teslimat başarısız olarak kalıyor ve elle gönderebiliyorsunuz. Tek satır için yeniden gönder, hepsi için başarısızları yeniden gönder.
Bir de test düğmesi var ve gönderdiği istek gerçek bir olay adı taşımıyor. Bu bilinçli, çünkü test isteği sizin otomasyonunuzu gerçek sanıp çalıştırmamalı.
Ölü bir adrese saatlerce istek gitmiyor
Art arda beş teslimat başarısız olursa bağlantı kendiliğinden duraklatılıyor ve yöneticilere bildirim gidiyor.
Bu bir silme değil. Seçtiğiniz olaylar ve daraltmalar yerinde duruyor, adresi düzelttikten sonra yeniden açıyorsunuz ve kaldığı yerden devam ediyor.
Duraklatma olmasaydı ölü bir adrese saatlerce istek göndermeye devam ederdik ve siz bunu hiç öğrenmezdiniz. Sessizce çalışmayan bir entegrasyon, hiç kurulmamış bir entegrasyondan daha tehlikeli.
Dört sınır
Bir adrese dakikada en fazla altmış istek gönderiliyor. Toplu bir işlem daha fazla olay üretirse kalanlar bir sonraki dakikaya aktarılıyor, kaybolmuyor.
İç ağ adresleri kabul edilmiyor. Yönlendirme takip edilmiyor, yani adresi son hâliyle yazın. İstek on saniyede yanıt gelmezse başarısız sayılıyor.
Gövde büyüyebilir, kırılmaz
Gövdeye yeni alanlar eklenebiliyor ve bu kırıcı bir değişiklik sayılmıyor. Alıcı tarafta tanımadığınız alanları yok saymanız yeterli.
Bir alanın kaldırılması ya da anlamının değişmesi gerekirse sürüm numarası artıyor ve eski sürüm bir süre gönderilmeye devam ediyor. Yani entegrasyonunuz bir sabah aniden bozulmuyor.
Nereden başlanır
Tek bir olayla başlayın. Kartın durumu değiştiğinde ya da bir koleksiyona kayıt yazıldığında yeter.
Alıcı tarafta ilk yapacağınız şey imzayı doğrulamak, ikinci yapacağınız şey olay kimliğini kaydedip aynı olayı iki kez işlememek olsun. Bu ikisi olmadan kurulan bir entegrasyon ilk yoğun günde sorun çıkarır.
Sonra teslimat günlüğüne bakın. Birkaç gerçek olay geçtikten sonra hangi alanların işinize yaradığını görür, aboneliği ona göre genişletirsiniz.
Olay listesi, imza doğrulama örneği ve sınırlar yardım merkezindeki Giden bağlantılar sayfasında duruyor. Dışarıdan gelen bir olayla Orbi'de iş başlatmak için Akışlar sayfasına bakabilirsiniz.
Denemek isterseniz ücretsiz bir hesap açıp ilk bağlantınızı kurabilirsiniz.