Resumo Executivo

n8n é um orquestrador de workflows que permite construir automações complexas com nodos para APIs, transformação de dados, armazenamento e execução condicional. Nesta página temos visão arquitetural, casos de uso e métricas de adoção. A seção de helpers contém exemplos práticos em JavaScript de funções utilitárias usadas em nodes personalizados.

Sumário de Helpers (referência rápida)

Lista rápida dos helpers documentados — clique para ver exemplos e padrões de uso.

assertBinaryData getBinaryDataBuffer prepareBinaryData setBinaryDataBuffer binaryToString httpRequest request httpRequestWithAuthentication requestWithAuthenticationPaginated copyBinaryFile createReadStream getBinaryStream binaryToBuffer getBinaryMetadata getStoragePath getBinaryPath writeContentToFile copyInputItems returnJsonArray normalizeItems getSSHClient createDeferredPromise constructExecutionMetaData

Arquitetura recomendada

Separar execução de workflows (workers) da camada de trigger (webhooks) por escalabilidade.
Usar volumes persistentes para armazenamento de binários e logs.
Autenticação centralizada para credenciais, preferindo secret manager.

Uso relativo de helpers (exemplo)

Frequência de chamadas (exemplo)

Gráfico ilustrativo: demonstra como priorizar documentação e testes para helpers mais usados.

Casos de uso

ETL e canais de mídia

Ingestão de arquivos binários (imagens, áudios), enriquecimento via APIs e publicação automática em plataformas.

Pipelines com autenticação paginada

Integração com APIs que paginam resultados: usar helpers de requisição paginada com retry e limites.

Consulte /n8n/helpers para exemplos em JavaScript de cada helper, patterns e anti-patterns.

Referências

Livros

Designing Data-Intensive Applications — M. Kleppmann
API Design Patterns — M. Amundsen