Tutorial Interativo Prático sobre Fundamentos de API - Fluxo de trabalho n8n

Iniciantes em n8n: Utilizadores novos na plataforma que precisam de entender como interagir com APIs externas.
Engenheiros de Automação: Profissionais que procuram modelos n8n robustos e ilustrativos para ensinar princípios de API aos membros da equipa.
Estudantes e Educadores: Indivíduos que necessitam de um guia prático e visual sobre métodos HTTP e arquitetura de API.
Qualquer Pessoa: Que procure um fluxo de trabalho n8n autónomo que não necessite de credenciais externas para ser executado.

Dominar a API (Interface de Programação de Aplicações) é essencial para qualquer especialista em automação. Este poderoso fluxo de trabalho n8n funciona como um ambiente de simulação de API autónomo. É um dos modelos n8n mais eficazes para iniciantes em API, simplificando conceitos complexos em cinco lições fáceis e executáveis.

A cadeia inteira de nós n8n utiliza uma analogia de restaurante onde o nó n8n HTTP Request é o 'Cliente' e o nó n8n Webhook é a 'Cozinha.' Ao executar este fluxo de trabalho n8n, executa instantaneamente cinco chamadas de API distintas e pode examinar a entrada e saída de cada nó n8n para ver como os parâmetros, cabeçalhos e corpos afetam a resposta. Esta abordagem interativa fornece feedback imediato, solidificando a sua compreensão sobre como construir automações de fluxo de trabalho n8n fiáveis que interagem com APIs do mundo real.

Todo este fluxo de trabalho n8n é iniciado por um gatilho (trigger) n8n manual, que calcula imediatamente o URL base necessário para todos os pedidos internos.

1. Preparação (URL Base): O gatilho n8n Start Tutorial ativa um nó n8n Set para construir dinamicamente o URL base necessário para as chamadas de webhook internas, garantindo que todo o fluxo de trabalho n8n seja executado sem problemas em modo de teste.


2. Lição 1 (Pedido GET): O nó n8n HTTP Request (O Cliente) envia um pedido GET simples para obter dados (a ementa/menu) do nó n8n Webhook alvo (A Cozinha).


3. Lição 2 (Parâmetros de Consulta): Um segundo nó n8n HTTP Request envia um pedido GET, mas inclui um parâmetro de consulta (?extra_cheese=true). O nó n8n Webhook recebe isto e usa um nó n8n IF para ramificar o fluxo de execução, demonstrando como as opções personalizam um pedido.


4. Lição 3 (Pedido POST e Corpo): O cliente envia um pedido POST, incluindo dados (uma avaliação do cliente) no corpo do pedido. O servidor (outro nó n8n Webhook) processa os dados e usa um nó n8n Set para ecoar o comentário recebido na sua resposta, ilustrando o envio de dados.


5. Lição 4 (Cabeçalhos e Autorização): O cliente envia um pedido que requer autorização. Inclui uma x-api-key nos cabeçalhos. O nó n8n Webhook verifica esta chave usando um nó n8n IF. Se a chave corresponder, o acesso é concedido; caso contrário, é devolvida uma resposta de erro.


6. Lição 5 (Tratamento de Timeout): O nó n8n HTTP Request final está configurado com um timeout de 2 segundos. O nó n8n Webhook correspondente tem um nó n8n Wait configurado para 3 segundos. O pedido é projetado para falhar devido a timeout, destacando a lógica crucial de tratamento de erros em qualquer fluxo de trabalho n8n robusto.

Para usar este modelo educativo de fluxo de trabalho n8n, siga estes passos simples:

1. Importar o JSON: Copie os dados JSON fornecidos.


2. Na sua instância n8n, clique em 'Novo' -> 'Importar de JSON' e cole os dados copiados.


3. Não São Necessárias Credenciais: Como este fluxo de trabalho n8n é autónomo e usa endereços Webhook internos, não são necessárias credenciais externas ou chaves de API.


4. Executar o Tutorial: Clique no botão 'Executar Fluxo de Trabalho' no canto superior direito para executar todo o fluxo de trabalho n8n a partir do gatilho n8n inicial. Inspecione as saídas de cada par 'Cliente' (nó n8n HTTP Request) e 'Cozinha' (nó n8n Webhook) para ver o fluxo de dados em ação.

Este tutorial utiliza vários tipos de nós n8n chave para simular uma conversa de API completa:

Gatilho Manual (Start Tutorial): O gatilho n8n inicial usado para iniciar manualmente a execução do fluxo de trabalho.
Set (URL Base, Responder com Menu, etc.): Usado extensivamente para calcular dinamicamente o URL base necessário para as chamadas de webhook e para elaborar as respostas JSON específicas que a 'Cozinha' devolve ao 'Cliente'.
Nó n8n Webhook (A Cozinha): Atua como o servidor de API simulado. Está configurado com caminhos específicos (/menu, /order, /review, etc.) e métodos HTTP (GET, POST) para escutar pedidos recebidos do nó n8n HTTP Request.
Nó n8n HTTP Request (O Cliente): Atua como o cliente da API, iniciando a chamada. Este é o nó n8n central na simulação, configurado para demonstrar funcionalidades específicas da API como enviar parâmetros de consulta, usar o método POST com um corpo, adicionar cabeçalhos personalizados e definir um timeout de pedido.
Nó n8n IF (Se queijo extra, Se Autorizado): Fornece controlo de fluxo com base na entrada recebida pelo nó n8n Webhook. Verifica parâmetros específicos (ex: parâmetros de consulta ou valores de cabeçalho) e direciona a resposta em conformidade.
Nó n8n Wait (Esperar 3 segundos): Usado na Lição 5 para simular uma resposta lenta da API. Este nó n8n atrasa a resposta do servidor o tempo suficiente (3 segundos) para garantir que o HTTP Request do cliente atinja o timeout (2 segundos), demonstrando o tratamento robusto de timeouts num fluxo de trabalho n8n complexo.