castomFLOW

Menyambung apa-apa sahaja

HTTP masuk, HTTP keluar, bahagian yang sukar dikendalikan

Setiap alat automasi mengiklankan bilangan integrasi. Bilangan itu sentiasa besar dan sentiasa soalan yang salah, kerana sistem yang sebenarnya anda perlukan ialah yang dibina sendiri pada tahun 2014 oleh seseorang yang telah pergi. Yang penting ialah seberapa baik alat itu bertutur dalam protokol di sebalik kesemuanya.

Sambungan sedia ada

Aplikasi yang paling banyak digunakan oleh perniagaan mempunyai langkah tersedia: kedai dan pasaran, perakaunan dan penginvoisan, hamparan dan pangkalan data, kalendar dan mel, storan dan pemesejan, CRM dan meja bantuan, penyedia pembayaran dan pengangkut penghantaran. Anda membenarkan akaun sekali sahaja dan medan-medan dinamakan dalam bahasa yang digunakan oleh aplikasi tersebut, bukan dalam bahasa JSON-nya.

Apabila sesuatu aplikasi mempunyai keistimewaan pasaran Poland — sistem penginvoisan yang perlu sedia untuk KSeF, pengangkut yang labelnya merupakan piawaian negara — langkah tersedia itu mengetahuinya, kerana keluarga ini menjual ke pasaran tersebut dan terpaksa mempelajarinya.

Dan kemudian kes umum

Segala yang lain ialah langkah HTTP, dan langkah HTTP di sini bukan hadiah penghibur. Ia adalah jentera yang sama dengan mana sambungan tersedia dibina, dengan pengendalian yang sama terhadap bahagian-bahagian yang membosankan untuk ditulis sendiri.

Bahagian yang membosankan

Dikendalikan, jadi anda tidak menulisnya semula

Pengesahan

Kekunci API, token pembawa, auth asas, OAuth 2 dengan segar semula, penandatanganan permintaan HMAC, TLS bersama. Kelayakan disimpan sekali sahaja, dirujuk dengan nama, dan tidak pernah dicetak ke dalam log atau rekod larian.

Paginasi

Kursor, nombor halaman, ofset, pengepala Link, dan API yang menandakan penghujung dengan memulangkan tatasusunan kosong. Nyatakan bentuknya dan langkah itu akan berjalan merentasi keseluruhan set.

Had kadar

Had atas setiap sambungan, dihormati merentasi setiap aliran kerja yang menggunakannya. Apabila pembekal membalas 429 dengan Retry-After, langkah itu menunggu selama itu dan bukannya menghantam berterusan.

Percubaan semula dan backoff

Kegagalan sementara dicuba semula dengan jurang yang semakin meningkat dan had atas. Langkah ialah fungsi tulen bagi inputnya, jadi percubaan semula menjalankan semula langkah itu dan bukannya menjalankan semula keseluruhan larian.

Muatan yang menyusahkan

JSON, pengekodan borang, XML, teks biasa, muat naik multipart. Respons dihuraikan kepada medan yang boleh anda rujuk mengikut nama, termasuk yang bersarang empat peringkat ke bawah.

Had masa

Had bagi setiap langkah, supaya satu pergantungan yang lambat tidak boleh menahan pekerja sementara segala-galanya di belakangnya beratur. Apa yang berlaku apabila had dicapai adalah keputusan anda, bagi setiap langkah.

Jika ia bertutur dalam HTTP, perbualan sudah pun bermula.

Webhook masuk, diberi perhatian serius

Setiap aliran kerja boleh mempunyai URL yang memulakannya. URL itu mengesahkan tandatangan — HMAC dalam bentuk yang digunakan oleh pembekal biasa, dan rahsia kongsi di mana itu sahaja yang mampu dilakukan oleh penghantar. Permintaan tanpa tandatangan kepada aliran kerja yang menjangkakan tandatangan ditolak dan direkodkan, bukan diproses secara senyap.

Penyahpenduaan dibuat berdasarkan pengecam muatan itu sendiri, jadi penghantar yang mencuba semula kerana tidak sempat melihat 200 anda mendapat satu larian dan bukannya tiga. Muatan yang cacat disimpan, bersama sebab ia ditolak, kerana punca paling biasa jurang yang misteri dalam automasi ialah penghantar yang berubah fikiran tentang sesuatu medan.

Sistem yang hanya bertutur dalam CSV

Ia wujud. Satu fail muncul pada pelayan SFTP pada pukul empat pagi, atau tiba sebagai lampiran, atau diletakkan dalam folder kongsi. Aliran kerja boleh memantau kehadirannya, membacanya, dan menganggap setiap baris sebagai rekod — termasuk fail dengan tanda susunan bait, pemisah titik bertitik dan baris pengepala dalam bahasa Poland, kerana itulah bentuk sebenar eksport tersebut.

Arah sebaliknya juga boleh: aliran kerja boleh menyusun satu fail dan meletakkannya di tempat sistem lain menjangkanya, dan itu kerap kali antara muka tunggal yang dimiliki oleh perisian dari tahun 2006.

Suapan pembekal setiap malamSFTP → HTTP
  • ⚡PencetusFail baharu pada SFTP pembekal: stock-2026-09-09.csv.
  • 2HuraiTitik bertitik, tanda susunan bait, pengepala Poland. 4 118 baris.
  • 3NormaliseKod mata wang disemak terhadap data rujukan; dua ditolak sebagai tidak sah.
  • 4TolakHTTP PATCH dalam kelompok 200, had kadar dihormati.
  • !PengecualianDua baris difailkan untuk seorang, dengan nombor baris dan sebabnya. 4 116 yang lain berjalan lancar.

Langkah yang memanggil model: 0Kos larian ini: tiada

Di mana kelayakan disimpan

Dienkrip, dirujuk mengikut nama, diskop kepada ruang kerja yang memilikinya, dan tidak pernah dipaparkan dalam log larian, mesej ralat atau perbualan sokongan. Rekod larian menunjukkan bahawa langkah mengesahkan diri sebagai supplier-sftp; ia tidak menunjukkan apa itu supplier-sftp.

Agensi yang menjalankan satu aliran kerja untuk tiga puluh pelanggan memberi setiap pelanggan set kelayakan tersendiri, dan aliran kerja merujuk kepada set itu dan bukannya rahsianya. Memutar kunci adalah satu suntingan di satu tempat — itulah sebab utama agensi datang ke sini.

Had yang patut diketahui: sistem yang langsung tiada antara muka — tiada API, tiada webhook, tiada penurunan fail, tiada apa-apa melainkan seorang yang menekan butang dalam pelayar — tidak boleh diautomasi oleh ini mahupun oleh apa-apa jua yang jujur. Tiada pelayar tanpa kepala yang berpura-pura menjadi pengguna di sini, kerana ia rosak pada kali pertama pihak lain mengalihkan butang, dan ia rosak secara senyap.