Her şeye bağlanmak

HTTP girişi, HTTP çıkışı, zahmetli kısımlar halledilmiş

Her otomasyon aracı bir entegrasyon sayısı reklamını yapar. Sayı her zaman büyüktür ve her zaman yanlış sorudur; çünkü gerçekten ihtiyaç duyduğunuz sistem, 2014'te artık gitmiş olan birinin şirket içinde yazdığı sistemdir. Önemli olan, aracın hepsinin altındaki protokolü ne kadar iyi konuştuğudur.

Hazır bağlantılar

İşletmelerin üzerinde çalıştığı uygulamalar için hazırlanmış adımlar vardır: mağazalar ve pazaryerleri, muhasebe ve faturalama, tablolar ve veritabanları, takvimler ve posta, depolama ve mesajlaşma, CRM'ler ve yardım masaları, ödeme sağlayıcıları ve kargo firmaları. Hesabı bir kez yetkilendirirsiniz ve alanlar, uygulamanın JSON diliyle değil, uygulamanın kendi diliyle adlandırılır.

Bir uygulamanın Polonya pazarına özgü bir durumu varsa — KSeF'e hazır olması gereken bir faturalama sistemi, etiketleri ulusal standart olan bir kargo firması — hazırlanmış adım bunu bilir; çünkü aile o pazara satıyor ve öğrenmek zorunda kaldı.

Ve sonra genel durum

Geri kalan her şey bir HTTP adımıdır ve buradaki bir HTTP adımı teselli ödülü değildir. Hazır bağlantıların üzerine kurulduğu makinenin aynısıdır; kendiniz yazması zahmetli olan kısımların da aynı halledişiyle.

Zahmetli kısımlar

Halledilmiş, böylece bir daha yazmazsınız

Kimlik doğrulama

API anahtarları, bearer token'lar, basic auth, yenilemeli OAuth 2, HMAC istek imzalama, karşılıklı TLS. Bir kimlik bilgisi bir kez saklanır, adıyla başvurulur ve asla bir günlüğe ya da çalışma kaydına yazdırılmaz.

Sayfalandırma

İmleçler, sayfa numaraları, ofsetler, Link başlıkları ve sonunu boş bir dizi döndürerek bildiren API. Şeklinin hangisi olduğunu söyleyin, adım tüm kümeyi yürür.

Hız sınırları

Bağlantı başına bir üst sınır; onu kullanan her iş akışında buna riayet edilir. Bir sağlayıcı Retry-After başlığıyla 429 yanıtı verdiğinde adım, sürekli vurmaya çalışmak yerine o kadar bekler.

Yeniden denemeler ve bekleme artışı

Geçici hatalar, artan aralıklarla ve bir üst sınırla yeniden denenir. Bir adım, girdilerinin saf bir işlevidir; bu yüzden yeniden deneme, tüm iş akışını değil yalnızca adımı yeniden çalıştırır.

Zorlu yükler

JSON, form kodlaması, XML, düz metin, multipart yüklemeleri. Yanıtlar, dört seviye aşağıda yuvalanmış olanlar dâhil, adıyla başvurabileceğiniz alanlara ayrıştırılır.

Zaman aşımları

Adım başına bir sınır; böylece yavaş bir bağımlılık, arkasındaki her şey kuyrukta beklerken bir çalışanı meşgul edemez. Sınıra ulaşıldığında ne olacağına karar vermek size aittir, adım başına.

HTTP konuşuyorsa, sohbet çoktan başlamıştır.

Gelen web kancaları, ciddiye alındığında

Her iş akışının onu başlatan bir URL'si olabilir. Bu URL imzaları doğrular — yaygın sağlayıcıların kullandığı biçimlerde HMAC ve gönderenin daha fazlasını beceremediği yerlerde paylaşılan bir gizli anahtar. İmza bekleyen bir iş akışına gelen imzasız istek, sessizce işlenmek yerine reddedilir ve kaydedilir.

Tekilleştirme, yükün kendi tanımlayıcısı üzerinden yapılır; böylece 200 yanıtınızı zamanında göremediği için yeniden deneyen bir gönderici, üç yerine tek bir çalıştırma elde eder. Bozuk yükler, reddedilme nedenleriyle birlikte saklanır; çünkü otomasyondaki açıklanamayan bir boşluğun en yaygın nedeni, bir alan konusundaki fikrini değiştirmiş bir göndericidir.

Yalnızca CSV konuşan sistemler

Onlar var. Sabah dörtte bir dosya SFTP sunucusunda belirir, ya da bir ek olarak gelir, ya da paylaşılan bir klasöre bırakılır. Bir iş akışı onu izleyebilir, okuyabilir ve her satırı bir kayıt olarak ele alabilir — bayt sırası işareti olan, noktalı virgülle ayrılmış ve başlık satırı Lehçe olan dosya dâhil, çünkü dışa aktarım gerçekten böyle görünür.

Ters yönü de çalışır: bir iş akışı bir dosya oluşturabilir ve onu diğer sistemin aramayı beklediği yere koyabilir; 2006 tarihli bir yazılım için bu çoğu zaman tek arayüzdür.

Gecelik tedarikçi akışıSFTP → HTTP

⚡Tetikleyici04:02Tedarikçinin SFTP'sinde yeni dosya: stock-2026-09-09.csv.
2AyrıştırNoktalı virgüller, bayt sırası işareti, Lehçe başlıklar. 4 118 satır.
3NormalleştirPara birimi kodları referans verilerle denetlendi; ikisi geçersiz olarak reddedildi.
4Gönder2.9 sHTTP PATCH, 200'lik gruplar hâlinde, hız sınırına riayet edilerek.
!İstisnalarBir kişi için dosyalanan iki satır, satır numarası ve nedenle birlikte. Diğer 4 116 sorunsuz geçti.

Model çağıran adım sayısı: 0Bu çalıştırmanın maliyeti: sıfır

Kimlik bilgileri nerede durur

Şifrelenmiş, adıyla referanslanmış, sahibi olan çalışma alanıyla sınırlı ve asla bir çalıştırma günlüğüne, hata iletisine veya destek görüşmesine yansıtılmaz. Bir çalıştırma kaydı, bir adımın supplier-sftp olarak kimlik doğruladığını gösterir; supplier-sftp'nin ne olduğunu göstermez.

Otuz müşterisi için tek bir iş akışı çalıştıran bir ajans, her müşteriye kendi kimlik bilgisi setini verir ve iş akışı gizli anahtarı değil sete atıfta bulunur. Bir anahtarı döndürmek tek yerde tek bir düzenlemedir — ajansların buraya gelmesinin nedeni de büyük ölçüde budur.

Bilinmesi gereken sınır: hiçbir arayüzü olmayan bir sistem — API'si olmayan, web kancası olmayan, dosya bırakma olmayan, yalnızca bir tarayıcıda tıklayan bir kişi olan — bu araçla ya da dürüst olan başka hiçbir araçla otomatikleştirilemez. Burada kendini kullanıcı gibi gösteren gizli bir tarayıcı yoktur; çünkü karşı taraf bir düğmeyi oynattığında ilk seferde bozulur ve sessizce bozulur.