Fluxos de API

A maior parte do trabalho com APIs não cabe em uma única requisição. Um login devolve o token de que a próxima chamada precisa; uma listagem precisa ser paginada; uma resposta precisa ser conferida antes da etapa seguinte rodar. O Lumen Flow é um ambiente nativo para macOS para projetar, executar, depurar e versionar fluxos de API — integrado ao Mac.

Um Flow é essa sequência, desenhada em um canvas em vez de espalhada por uma pasta de requisições soltas.

As etapas que você coloca no canvas

Todo Flow é montado com nós tipados, cada um com uma função:

• Chamada HTTP · método, URL, headers e corpo, com a credencial herdada do Space ou definida só para aquela etapa.
• Condição · divide o Flow em um caminho verdadeiro e um falso.
• Loop · repete um conjunto de etapas.
• Paralelo · executa ramificações independentes ao mesmo tempo, em vez de uma depois da outra.
• Atribuir variável · captura um valor e o deixa disponível para as etapas seguintes.
• Validação · declara como a resposta precisa ser e marca a etapa como falha quando não é.
• Transformação · remodela um payload por script antes de repassá-lo.
• Script de ação · um script de pré ou pós-requisição reutilizável, mantido em um só lugar e compartilhado entre etapas.
• Executar flow · chama outro Flow como sub-rotina.

Os valores circulam entre as etapas por variáveis: o resultado de uma etapa anterior, uma variável do Profile ativo, um campo de uma credencial ou o resultado de uma Action.

Execute e veja o que de fato aconteceu

Executar um Flow abre o Inspector. Não é um despejo de log — é a execução, etapa por etapa:

• quais etapas rodaram e se cada uma teve sucesso, falhou ou foi ignorada;
• a requisição e a resposta completas, lado a lado, em cada chamada — status, headers, corpo;
• quais validações passaram e quais não passaram;
• o estado das suas variáveis ao final da execução.

Em uma condição, você vê qual caminho foi seguido. Em um loop, quantas iterações rodaram. Quando o endpoint ainda não existe, uma etapa de chamada pode devolver uma resposta simulada, para você montar e testar o resto do Flow em volta dela.

Comece do que você já tem

Raramente se começa do zero:

• Cole um comando cURL · ele é interpretado direto em uma etapa de chamada, com método, URL, headers e corpo preenchidos. Sem IA envolvida e sem faxina depois.
• Importe uma coleção · arquivos do Postman, OpenAPI, Insomnia e Bruno são reconhecidos pelo conteúdo, então você não precisa dizer ao app qual formato está entregando. Antes de qualquer coisa ser criada, você vê um resumo do que foi encontrado e pode desmarcar flows, credenciais ou profiles individualmente.

Os segredos que vêm junto com uma coleção importada são guardados no Keychain do macOS, não em texto plano.