castomFLOW
Abrir castomFLOW

Conectar calquera cousa

HTTP entra, HTTP sae, as partes incómodas xestionadas

Toda ferramenta de automatización anuncia un número de integracións. O número sempre é grande e sempre é a pregunta equivocada, porque o sistema que realmente necesitas é o que se construíu internamente en 2014 por alguén que xa non está. O que importa é como de ben fala a ferramenta o protocolo que hai debaixo de todas elas.

As conexións xa preparadas

As aplicacións nas que se apoian a maioría das empresas teñen pasos preparados: tendas e marketplaces, contabilidade e facturación, folla de cálculo e bases de datos, calendarios e correo, almacenamento e mensaxería, CRMs e helpdesks, provedores de pagamento e transportistas. Autorizas a conta unha vez e os campos levan os nomes na linguaxe que usa a aplicación, non na linguaxe do seu JSON.

Cando unha aplicación ten unha particularidade do mercado polaco — un sistema de facturación que ten que estar listo para KSeF, un transportista cuxas etiquetas son un estándar nacional — o paso preparado xa o sabe, porque a familia vende nesse mercado e tivo que aprender.

E despois o caso xeral

Todo o demais é un paso HTTP, e un paso HTTP aquí non é un premio de consolo. É a mesma maquinaria na que están construídas as conexións preparadas, coa mesma xestión das partes tediosas de escribir por ti mesmo.

As partes tediosas

Xestionadas, para que non as volvas escribir

Autenticación

Claves de API, tokens bearer, autenticación básica, OAuth 2 con refresco, asinatura de peticións HMAC, TLS mutuo. Unha credencial gárdase unha vez, referénciase polo nome e nunca se imprime nun rexistro ou nunha execución.

Paxinación

Cursores, números de páxina, offsets, cabeceiras Link e a API que sinala a fin devolvendo unha matriz baleira. Di que forma é e o paso percorre todo o conxunto.

Límites de velocidade

Un límite por conexión, respectado en todos os fluxos que a usan. Cando un provedor responde 429 con un Retry-After, o paso agarda ese tempo en vez de insistir.

Reintentos e retardo

Os fallos transitorios reintentanse cun intervalo crecente e un tope. Un paso é unha función pura das súas entradas, polo que un reintento volve executar o paso, non toda a execución.

Cargas problemáticas

JSON, codificación de formularios, XML, texto plano, subidas multipart. Respostas analizadas en campos que podes referenciar polo nome, incluídos os que están catro niveis máis abaixo.

Tempos de espera

Un límite por paso, de xeito que unha dependencia lenta non poida bloquear un worker mentres todo o demais fai cola. Que pasa ao alcanzar o límite é decisión túa, paso por paso.

Se fala HTTP, a conversa xa comezou.

Webhooks entrantes, tomados en serio

Cada fluxo pode ter un URL que o inicie. Ese URL verifica sinaturas —HMAC nas formas que usan os provedores habituais, e un segredo compartido cando iso é todo o que o emisor pode ofrecer. Unha petición sen sinatura a un fluxo que espera unha sinatura rexeitase e rexístrase, non se procesa discretamente.

A deduplicación baséase no identificador propio da carga, de xeito que un emisor que reintenta porque non viu o teu 200 a tempo obtén unha execución en vez de tres. As cargas mal formadas consérvanse, co motivo do rexeitamento, porque a causa máis común dun oco misterioso nunha automatización é un emisor que mudou de opinión sobre un campo.

Os sistemas que só falan CSV

Existen. Un ficheiro aparece nun servidor SFTP ás catro da mañá, ou chega como anexo, ou déixase nun cartafol compartido. Un fluxo pode vixialo, lelo e tratar cada fila como un rexistro —incluído o ficheiro con marca de orde de bytes, separadores de punto e coma e unha fila de cabeceira en polaco, porque é exactamente como é a exportación.

No sentido contrario tamén funciona: un fluxo pode montar un ficheiro e deixalo onde o outro sistema espera atopalo, o que adoita ser a única interface que ten un software de 2006.

Fonte nocturna de provedoresSFTP → HTTP
  • ⚡ActivadorNovo ficheiro no SFTP do provedor: stock-2026-09-09.csv.
  • 2AnalizarPuntos e comas, marca de orde de bytes, cabeceiras en polaco. 4 118 filas.
  • 3NormalizarCódigos de moeda verificados contra os datos de referencia; dous rexeitados por non seren válidos.
  • 4EnviarHTTP PATCH en lotes de 200, respectando o límite de velocidade.
  • !ExcepciónsDúas filas arquivadas para unha persoa, co número de fila e o motivo. As outras 4 116 pasaron.

Pasos que chamaron a un modelo: 0Custo desta execución: nada

Onde viven as credenciais

Cifradas, referenciadas polo nome, limitadas ao espazo de traballo que as posúe, e nunca incluídas nun rexistro de execución, unha mensaxe de erro ou unha conversa de soporte. Un rexistro de execución mostra que un paso autenticouse como supplier-sftp; non mostra o que é supplier-sftp.

Unha axencia que executa un fluxo para trinta clientes dálle a cada cliente o seu propio conxunto de credenciais, e o fluxo refírese ao conxunto en vez do segredo. Rotar unha chave é unha edición nun só lugar —que é a maior razón pola que as axencias veñen aquí.

O límite que convén coñecer: un sistema sen ningunha interface —sen API, sen webhook, sen depósito de ficheiros, nada máis que unha persoa facendo clic nun navegador— non pode automatizarse con isto nin con nada honesto. Aquí non hai navegador sen cabeza facéndose pasar por un usuario, porque rompe á primeira en canto o outro lado move un botón, e rompe en silencio.