Nyambungaké apa waé

HTTP mlebu, HTTP metu, bagéyan sing angel ditangani

Saben piranti otomatisasi ngiklanake cacahé integrasi. Cacahé tansah gedhe lan tansah pitakonan sing salah, amarga sistem sing kok butuhaké asliné sing digawe internal taun 2014 dening wong sing wis lunga. Sing penting yaiku kepriye piranti bisa ngomong protokol ing ngisor kabehé.

Sambungan sing wis ana

Aplikasi sing paling akeh dienggo bisnis wis duwe langkah sing disiapake: toko lan marketplace, akuntansi lan faktur, spreadsheet lan basis data, kalender lan layang, panyimpenan lan pesen, CRM lan helpdesk, panyedhiya bayaran lan kurir. Kok otorisasi akun sepisan lan kolomé dijenengi nganggo basa sing dienggo aplikasiné, dudu basa JSONé.

Nalika aplikasi duwe kaanan khusus pasar Polandia — sistem faktur sing kudu siap KSeF, kurir sing labelé dadi standar nasional — langkah sing disiapake ngerti babagan iku, amarga kulawarga iki adol ing pasar kasebut lan kudu sinau.

Banjur kasus umum

Sisané kabeh yaiku langkah HTTP, lan langkah HTTP ing kene dudu bebungah panglipur. Iku mesin sing padha karo sing dienggo nggawe sambungan sing wis ana, kanthi penanganan sing padha kanggo bagéyan sing males yèn ditulis dhéwé.

Bagéyan sing males

Wis ditangani, mula ora perlu ditulis maneh

Otentikasi

Kunci API, token bearer, basic auth, OAuth 2 karo refresh, panandha request HMAC, TLS mutual. Kredensial disimpen sepisan, dirujuk jenengé, lan ora tau dicithak menyang log utawa cathetan run.

ꦥꦒꦶꦤꦱꦶ

Kursor, nomer kaca, offset, header Link, lan API sing mèngeti pungkasan kanthi ngasilaké larik kosong. Sebutna wujudé sing endi, banjur langkahé bisa lumaku ing kabeh set.

Watesan laju

Batas saben sambungan, diurmati ing saben alur kerja sing nganggo. Nalika panyedhiya mbalekaké 429 karo Retry-After, langkahé ngenteni suwéné kuwi, ora nggusah-gusah.

Percobaan manèh lan backoff

Kagagalan sementara dicoba manèh kanthi jarak sing tambah terus lan ana watesé. Langkah iku fungsi murni saka inputé, dadi nyoba manèh nglakokaké langkahé waé, ora kabeh run.

Muatan sing angel

JSON, encoding formulir, XML, teks polos, unggahan multipart. Balesan diurai dadi kolom sing bisa diarani jenengé, kalebu sing ana papat tingkat ing jero.

Watesan wektu

Batas saben langkah, supaya siji dependensi sing alon ora bisa nyandhaké worker nalika kabeh sing ing mburiné ngantre. Sing kedadeyan nalika watesé kena iku putusanmu, saben langkah.

Yen bisa ngomong HTTP, pasrawungané wis diwiwiti.

Webhook mlebu, ditanggapi serius

Saben alur kerja bisa duwé URL sing miwiti. URL iku mriksa tanda tangan — HMAC ing wujud sing umum dienggo panyedhiya, lan rahasia sing dienggo bebarengan nalika iku mung sing bisa ditindakaké pangirim. Panjalukan tanpa tanda tangan menyang alur kerja sing njaluk tanda tangan ditolak lan dicathet, ora diolah kanthi diam.

Deduplikasi adhedhasar identifikatoré muatané dhéwé, dadi pangirim sing nyoba manèh amarga ora weruh 200-mu pas wektune mung entuk siji run, ora telu. Muatan sing rusak disimpen, bebarengan alesané ditolak, amarga sebab paling umum bolongan misterius ing otomatisasi yaiku pangirim sing owah pikiran babagan sawijining kolom.

Sistem sing mung bisa ngomong CSV

Ana. Berkas muncul ing server SFTP jam papat esuk, utawa teka minangka lampiran, utawa didhèlèh ing folder sing dienggo bebarengan. Alur kerja bisa ngawasi, maca, lan nglakoni saben baris minangka cathetan — kalebu berkas sing duwé byte-order mark, pamisah titik koma, lan baris header ing basa Polen, amarga iku wujud asli eksporé.

Balané arah uga bisa: alur kerja bisa ngrakit berkas lan nglebokaké ing panggonan sing dikarepaké sistem liyané, sing asring dadi antarmuka tunggal saka piranti lunak taun 2006.

Pasokan pemasok saben wengiSFTP → HTTP

⚡Pemicu04:02Berkas anyar ing SFTP pemasok: stock-2026-09-09.csv.
2NguraiTitik koma, byte-order mark, header Polen. 4 118 baris.
3NormalisasiKode mata uang dicek marang data referensi; loro ditolak amarga ora sah.
4Surung2.9 sHTTP PATCH ing batch 200, watesan laju diurmati.
!PangecualianLoro baris difilekaké kanggo wong, karo nomer barisé lan alesané. Liyané 4 116 lumebu kabeh.

Langkah sing nyeluk model: 0Biyaya run iki: ora ana

Ing ngendi kredensial disimpen

Dienkripsi, diarani jenengé, diwatesi ing workspace sing duwé, lan ora tau ditampilaké ing run log, pesen kesalahan, utawa rembugan dhukungan. Cathetan run nuduhaké yèn langkah otentikasi minangka supplier-sftp; ora nuduhaké apa supplier-sftp iku.

Agensi sing nganggo siji alur kerja kanggo telung puluh klien mènèhi saben klien set kredensialé dhéwé, lan alur kerja ngrujuk marang set, ora rahasiané. Ngganti kunci mung siji suntingan ing siji panggonan — iku alesan utama agensi teka kene.

Watesan sing perlu dingerteni: sistem sing ora duwé antarmuka apa-apa — ora API, ora webhook, ora panggonan file, mung wong sing ngeklik ing browser — ora bisa diotomatisasi kene utawa karo apa waé sing jujur. Ora ana browser tanpa tampilan sing ngaku dadi panganggo ing kene, amarga iku rusak sepisanan nalika pihak liya mindhahaké tombol, lan rusak kanthi diam.