castomFLOW

Connectar qualsevol cosa

HTTP d'entrada, HTTP de sortida, les parts feixugues resoltes

Tota eina d'automatització anuncia un nombre d'integracions. El nombre sempre és gran i sempre és la pregunta equivocada, perquè el sistema que realment necessites és el que es va construir internament el 2014 algú que ja se n'ha anat. El que importa és com de bé l'eina parla el protocol que hi ha a sota de totes.

Les connexions ja preparades

Les aplicacions amb què treballen la majoria d'empreses tenen passos preparats: botigues i mercats, comptabilitat i facturació, fulls de càlcul i bases de dades, calendaris i correu, emmagatzematge i missatgeria, CRM i helpdesks, proveïdors de pagament i transportistes. Autoritzes el compte una vegada i els camps porten el nom que fa servir l'aplicació, no el llenguatge del seu JSON.

Quan una aplicació té una particularitat del mercat polonès — un sistema de facturació que ha d'estar a punt per al KSeF, un transportista les etiquetes del qual són un estàndard nacional —, el pas preparat en té coneixement, perquè la família ven en aquest mercat i ho va haver d'aprendre.

I després el cas general

Tot el que queda és un pas HTTP, i un pas HTTP aquí no és un premi de consolació. És la mateixa maquinària sobre la qual es construeixen les connexions preparades, amb el mateix tractament de les parts que són tedioses d'escriure tu mateix.

Les parts tedioses

Resoltes, perquè no les hagis d'escriure una altra vegada

Autenticació

Claus d'API, tokens bearer, autenticació bàsica, OAuth 2 amb refresc, signatura de peticions HMAC, TLS mutu. Una credencial s'emmagatzema una vegada, es referencia pel nom i mai no s'imprimeix en un registre ni en un historial d'execució.

Paginació

Cursors, números de pàgina, offsets, capçaleres Link i l'API que senyala el final retornant una matriu buida. Digues quina forma és i el pas recorre tot el conjunt.

Límits de freqüència

Un sostre per connexió, respectat a tots els fluxos de treball que l'utilitzen. Quan un proveïdor respon 429 amb un Retry-After, el pas espera aquest temps en comptes d'insistir.

Reintents i retrocés

Els errors transitoris es reintenten amb un interval creixent i un límit. Un pas és una funció pura de les seves entrades, de manera que un reintento torna a executar el pas, no tota l'execució.

Càrregues complicades

JSON, codificació de formularis, XML, text pla, pujades multipart. Les respostes s'analitzen en camps que pots referenciar pel nom, inclosos els que estan quatre nivells més avall.

Temps d'espera

Un límit per pas, de manera que una dependència lenta no pot retenir un treballador mentre tot el que ve després queda en cua. Què passa en arribar al límit és decisió teva, pas per pas.

Si parla HTTP, la conversa ja ha començat.

Webhooks entrants, presos seriosament

Cada flux de treball pot tenir un URL que l'inicia. Aquest URL verifica signatures — HMAC en els formats que fan servir els proveïdors habituals, i un secret compartit on això és tot el que pot oferir el remitent. Una petició sense signatura a un flux que espera una signatura es rebutja i es registra, no es processa en silenci.

La desduplicació es fa sobre l'identificador propi de la càrrega, de manera que un remitent que reintenta perquè no va veure a temps el teu 200 obté una execució en comptes de tres. Les càrregues malformades es conserven, amb el motiu pel qual es van rebutjar, perquè la causa més habitual d'un buit misteriós en una automatització és un remitent que va canviar d'opinió sobre un camp.

Els sistemes que només parlen CSV

Existeixen. Un fitxer apareix en un servidor SFTP a les quatre del matí, o arriba com a adjunt, o es deixa en una carpeta compartida. Un flux de treball pot vigilar-lo, llegir-lo i tractar cada fila com un registre — incloent-hi el fitxer amb marca d'ordre de bytes, separadors de punt i coma i una fila de capçaleres en polonès, perquè és així com és realment l'exportació.

En l'altre sentit també funciona: un flux de treball pot muntar un fitxer i deixar-lo on l'altre sistema espera trobar-lo, que sovint és l'única interfície que té un programari del 2006.

Alimentació nocturna de proveïdorSFTP → HTTP
  • ⚡ActivadorFitxer nou al SFTP del proveïdor: stock-2026-09-09.csv.
  • 2AnalitzaPunt i coma, marca d'ordre de bytes, capçaleres en polonès. 4.118 files.
  • 3NormalitzaCodis de moneda comprovats contra dades de referència; dos rebutjats com a invàlids.
  • 4PujaHTTP PATCH en lots de 200, respectant el límit de freqüència.
  • !ExcepcionsDues fitxades per a una persona, amb el número de fila i el motiu. Les altres 4.116 han passat.

Passos que han cridat un model: 0Cost d'aquesta execució: res

On viuen les credencials

Xifrades, referenciades pel nom, amb àmbit limitat a l'espai de treball que les posseeix, i mai mostrades en un registre d'execució, un missatge d'error o una conversa de suport. Un registre d'execució mostra que un pas s'ha autenticat com a supplier-sftp; no mostra què és supplier-sftp.

Una agència que executa un flux per a trenta clients dona a cada client el seu propi conjunt de credencials, i el flux fa referència al conjunt, no al secret. Rotar una clau és una única edició en un únic lloc — que és la major part del motiu pel qual les agències venen aquí.

El límit que val la pena conèixer: un sistema sense cap mena d'interfície — sense API, sense webhook, sense dipòsit de fitxers, res més que una persona clicant en un navegador — no es pot automatitzar ni amb això ni amb res d'honrat. Aquí no hi ha cap navegador headless fent-se passar per un usuari, perquè es trenca la primera vegada que l'altra banda mou un botó, i es trenca en silenci.