castomFLOW

連接任何嘢

HTTP 入、HTTP 出,麻煩位我哋搞掂

每個自動化工具都宣傳自己有幾多整合。個數字永遠好大,而且永遠都問錯問題,因為你真正需要嘅系統,係 2014 年某個已經離職嘅人喺公司內部寫嗰個。真正重要嘅係,個工具講唔講得好嗰個喺所有整合底下嘅協定。

現成嘅連接

大部分企業用緊嘅應用程式都有預備好嘅步驟:商店同市集、會計同開發票、試算表同資料庫、日曆同郵件、儲存同訊息、CRM 同客服系統、支付供應商同物流商。你授權個帳戶一次,欄位就會用嗰個應用程式嘅語言命名,而唔係佢 JSON 嘅語言。

如果某個應用程式有波蘭市場嘅特殊性——例如發票系統要符合 KSeF、某個物流商嘅標籤係國家標準——預備好嘅步驟都會識處理,因為呢個家族係賣入嗰個市場嘅,唔學唔得。

然後係一般情況

其餘所有嘢都係一個 HTTP 步驟,而呢度嘅 HTTP 步驟唔係安慰獎。佢同現成連接用嘅係同一套機制,嗰啲自己寫好麻煩嘅部分都有同樣嘅處理。

麻煩嘅部分

已經處理好,你唔使再寫一次

身份驗證

API 金鑰、bearer token、basic auth、有 refresh 嘅 OAuth 2、HMAC 請求簽名、雙向 TLS。憑證只儲存一次,用名稱引用,永遠唔會印入 log 或者執行紀錄。

分頁

游標、頁碼、offset、Link header,同埋用空陣列表示完結嘅 API。你話畀個步驟知係邊種形態,佢就會行晒成個集合。

速率限制

每個連接設一個上限,所有用到佢嘅工作流程都會遵守。當供應商回覆 429 並附帶 Retry-After,呢一步會等夠嗰段時間,而唔係狂撞。

重試同退避

暫時性錯誤會以遞增嘅間隔重試,並設上限。一步係輸入嘅純函數,所以重試係重跑嗰一步,而唔係重跑成個運行。

難搞嘅資料格式

JSON、表單編碼、XML、純文字、multipart 上載。回應會解析成你可以用名稱引用嘅欄位,包括嵌套四層深嗰啲。

逾時

每步設時限,咁樣一個慢嘅依賴就唔會佔住一個 worker,令後面全部嘢排隊。到時限嗰陣點處理,由你每步自己決定。

只要佢識講 HTTP,對話其實已經開始咗。

認真對待嘅入站 webhook

每個工作流程都可以有一個啟動佢嘅 URL。嗰個 URL 會驗證簽名——HMAC 用常見供應商嘅格式,而對方只能做到咁多嘅話,就用共享密鑰。一個要求簽名嘅工作流程收到無簽名嘅請求,會被拒絕並記錄低,而唔係靜靜雞處理咗佢。

去重係根據資料本身嘅識別碼,所以發送方因為未及時見到你個 200 而重發,只會得一個運行,唔會有三個。格式錯嘅資料會保留,連同被拒嘅原因,因為自動化出現神秘空隙最常見嘅原因,就係發送方對某個欄位改咗主意。

淨係識講 CSV 嘅系統

佢哋真係存在。凌晨四點一個檔案喺 SFTP 伺服器上出現,或者以附件形式到達,或者被放入共用資料夾。工作流程可以監察佢、讀取佢,將每行當一條記錄——包括有 byte-order mark、用分號分隔、表頭係波蘭文嘅檔案,因為匯出嚟就係咁嘅樣。

反方向都得:工作流程可以組裝一個檔案,放到對方系統預期搵到嘅位置——2006 年嘅軟件好多時得呢一個介面。

每晚供應商資料SFTP → HTTP
  • ⚡觸發條件供應商 SFTP 有新檔案:stock-2026-09-09.csv。
  • 2解析分號、byte-order mark、波蘭文表頭。4 118 行。
  • 3標準化貨幣代碼對照參考資料核對;兩個因為無效被拒。
  • 4推送HTTP PATCH,每批 200 個,遵守速率限制。
  • !例外兩行交畀一個人處理,附上行號同原因。其餘 4 116 行順利通過。

調用模型嘅步驟:0今次運行嘅成本:零

憑證放喺邊

加密儲存、用名稱引用、限定喺擁有佢嘅工作區內,而且永遠唔會出現喺運行日誌、錯誤訊息或者支援對話入面。運行記錄會顯示某一步以 supplier-sftp 身份驗證;但唔會顯示 supplier-sftp 係乜。

一間為三十個客戶行同一個工作流程嘅代理公司,可以畀每個客戶自己一套憑證,工作流程引用嗰套而唔係引用密鑰。換一條 key 只係喺一個地方改一次——呢個正正係代理公司嚟呢度嘅主要原因。

值得知道嘅限制:一個完全冇介面嘅系統——冇 API、冇 webhook、冇檔案投放,淨係得人喺瀏覽器入面撳嚟撳去——唔係呢度,亦唔係任何誠實嘅工具可以自動化到。呢度冇假裝係用戶嘅 headless 瀏覽器,因為對方一搬個掣佢就會壞,而且係靜靜雞咁壞。