Злучэнне з чым заўгодна
HTTP на ўваходзе, HTTP на выхадзе, нязручныя часткі ўжо вырашаны
Кожны інструмент аўтаматызацыі рэкламуе колькасць інтэграцый. Гэтая колькасць заўсёды вялікая і заўсёды няправільнае пытанне, бо сістэма, якая вам сапраўды патрэбна, — гэта тая, што напісана ўласнаручна ў 2014 годзе чалавекам, які сышоў. Важна тое, наколькі добра інструмент валодае пратаколам, што ляжыць пад усімі імі.
Гатовыя злучэнні
Для праграм, на якіх працуюць большасць кампаній, падрыхтаваны крокі: крамы і маркетплэйсы, бухгалтэрыя і выставанне рахункаў, табліцы і базы даных, календары і пошта, сховішчы і мэсэнджары, CRM і helpdesk, плацёжныя правайдэры і перавозчыкі. Вы аўтарызуеце ўліковы запіс адзін раз, і палі названы мовай самой праграмы, а не мовай яе JSON.
Калі ў праграмы ёсць асаблівасць польскага рынка — сістэма выставання рахункаў, гатовая да KSeF, перавозчык, чые этыкеткі з'яўляюцца нацыянальным стандартам, — падрыхтаваны крок пра гэта ведае, бо сямейства прадаецца на гэтым рынку і вымушана было вывучыць.
А потым — агульны выпадак
Усё астатняе — гэта HTTP-крок, і HTTP-крок тут — не суцяшальны прыз. Гэта тая ж механіка, на якой пабудаваны гатовыя злучэнні, з той жа апрацоўкай частак, стомных для ўласнаручнага напісання.
Стомныя часткі
Ужо вырашаны, каб вам не давялося пісаць іх зноў
Аўтэнтыфікацыя
API-ключы, bearer-токены, basic auth, OAuth 2 з абнаўленнем, подпіс запытаў HMAC, узаемны TLS. Уліковы дадзеныя захоўваецца адзін раз, выклікаецца па імені і ніколі не трапляе ў журнал або запіс выканання.
Пагінацыя
Курсары, нумары старонак, зрушэнні, загалоўкі Link і API, што сігналізуе пра канец вяртаннем пустога масіва. Пакажыце, які гэта варыянт, і крок пойдзе ўвесь набор.
Ліміты запытаў
Абмежаванне на адно злучэнне, якое выконваецца ва ўсіх працоўных працэсах, дзе яно выкарыстоўваецца. Калі правайдар адказвае 429 з Retry-After, крок чакае ўказаны час, а не штурмуе сервер.
Паўторы і затрымкі
Часовыя збоі паўтараюцца з павелічэннем інтэрвалу і з абмежаваннем колькасці. Крок — чыстая функцыя сваіх уваходных даных, таму паўтор перазапускае крок, а не ўвесь працэс.
Незручныя даныя
JSON, form-кадаванне, XML, звычайны тэкст, multipart-загрузкі. Адказы разбіраюцца ў палі, да якіх можна звяртацца па імені, у тым ліку тыя, што ляжаць на чацвёртым узроўні ўкладання.
Тайм-аўты
Абмежаванне на кожны крок, таму адна павольная залежнасць не трымае воркера, пакуль усё астатняе чакае ў чарзе. Што рабіць пры дасягненні ліміту — вырашаеце вы, для кожнага крока.
Калі сістэма размаўляе па HTTP, размова ўжо пачалася.
Уваходныя вэбхукі, да якіх ставяцца сур'ёзна
Кожны працоўны працэс можа мець URL, які яго запускае. Гэты URL правярае подпісы — HMAC у тых формах, якія выкарыстоўваюць распаўсюджаныя правайдары, і агульны сакрэт там, дзе гэта ўсё, што адпраўнік можа сабе дазволіць. Запыт без подпісу да працэсу, які чакае подпіс, адхіляецца і фіксуецца, а не ціха апрацоўваецца.
Дэдуплікацыя працуе па ўласным ідэнтыфікатары даных, таму адпраўнік, які паўтарае адпраўку, бо не паспеў убачыць ваш 200, атрымлівае адзін запуск, а не тры. Пашкоджаныя даныя захоўваюцца разам з прычынай адхілення, бо найчасцейшая прычына таямнічага прабелу ў аўтаматызацыі — адпраўнік, які перадумаў наконт поля.
Сістэмы, якія разумеюць толькі CSV
Яны існуюць. Файл з'яўляецца на SFTP-серверы а чацвёртай раніцы, прыходзіць укладаннем або трапляе ў агульную папку. Працоўны працэс можа сачыць за ім, прачытаць яго і апрацаваць кожны радок як запіс — у тым ліку файл з BOM, коскамі з кропкай у якасці раздзяляльнікаў і загалоўкамі па-польску, бо менавіта так выглядае рэальны экспарт.
Працуе і зваротны кірунак: працоўны працэс можа сабраць файл і пакласці яго там, дзе іншая сістэма чакае яго знайсці, — гэта часта адзіны інтэрфейс праграмы 2006 года.
- ⚡ТрыгерНовы файл на SFTP пастаўшчыка:
stock-2026-09-09.csv. - 2РазборКоскі з кропкай, BOM, польскія загалоўкі. 4 118 радкоў.
- 3НармалізацыяКоды валют правераны па даведачных даных; два адхілены як несапраўдныя.
- 4АдправіцьHTTP
PATCHпакетамі па 200, з выкананнем ліміту запытаў. - !ВыключэнніДва радкі адкладзены для чалавека, з нумарам радка і прычынай. Астатнія 4 116 прайшлі.
Крокі, што звярталіся да мадэлі: 0Кошт гэтага запуску: нішто
Дзе жывуць уліковыя даныя
Зашыфраваныя, зварот па імені, абмежаваны працоўнай прасторай, якой належаць, і ніколі не трапляюць у журнал запуску, паведамленне пра памылку ці размову з падтрымкай. Запіс запуску паказвае, што крок аўтэнтыфікаваўся як supplier-sftp; ён не паказвае, што такое supplier-sftp.
Агенцтва, якое запускае адзін працэс для трыццаці кліентаў, дае кожнаму кліенту свой набор уліковых даных, а працэс звяртаецца да набору, а не да сакрэта. Ратацыя ключа — гэта адна праўка ў адным месцы — і гэта галоўная прычына, па якой агенцтвы сюды прыходзяць.
Абмежаванне, якое варта ведаць: сістэму без усякага інтэрфейсу — без API, без вэбхукоў, без файлаў, толькі чалавек, што пстрыкае ў браўзеры, — немагчыма аўтаматызаваць ні гэтым інструментам, ні чымся іншым сумленным. Тут няма headless-браўзера, які прытвараецца карыстальнікам, бо ён ломіцца адразу, як толькі іншы бок перасуне кнопку, — і ломіцца ціха.