O que é um API Gateway? | Como pode realmente fornecer resultados práticos

"O termo API apareceu muito antes da World Wide Web. Mais recentemente um novo termo apareceu: API gateway. Parece um pouco estranho no início, pois o conceito API em si já sugere uma porta de entrada".

Ainda bem que perguntaste! Talvez se lembre que o termo API surgiu muito antes da World Wide Web e, com sorte, sabe que API significa “Application Programming Interface” (Interface de Programação de Aplicações).

Mas, mais recentemente, surgiu um novo termo: “API gateway”. À primeira vista, parece um pouco estranho, uma vez que o conceito de API, por si só, já sugere um gateway. Pode deixar-nos a pensar “o que é um gateway de API?”.

Em poucas palavras, um gateway API é uma ferramenta de gerenciamento que fica entre um cliente e uma coleção de serviços backendcada um com a sua própria API.

Portanto, o API gateway atua como um ponto de entrada único para um grupo definido de APIs. O cliente, neste caso, será normalmente uma aplicação de utilizador final.

De um ponto de vista mais técnico, também pode considerar um gateway de API como um proxy reverso especializado que pode fazer com que diferentes APIs apareçam como se fossem uma única API.

O termo “API gateway” é frequentemente utilizado num contexto de microsserviços. A granularidade dos APIs fornecidos pelos microserviços é muitas vezes diferente do que é necessário. Isto resulta simplesmente do conceito de microserviços: há várias pequenas peças que fazem pequenas coisas diferentes.

Os microserviços normalmente fornecem APIs de granulação fina, o que significa que os clientes precisam interagir com vários serviços. Por exemplo, um cliente que precisa dos detalhes de um produto facilmente pode precisar buscar dados de vários serviços. É por isso que um gateway API faz sentido no mundo dos microserviços.

Neste contexto e dentro de uma arquitetura de microserviços, novamente o objetivo do API gateway é apresentar um ponto de entrada único para todos os clientesmas, neste caso, isto é feito. principalmente pela simplificação do API apresentado aos clientes.

arquitetura de gateway API

Neste diagrama, você pode ver um gateway API está na borda dos sistemas. Actua como uma ferramenta de gestão ou middleware que medeia entre um cliente e um conjunto de serviços backend.

Estes os serviços backend podem mudar localização, arquitetura e implementação (linguagem, estrutura e outros) com impacto mínimo.

Não precisa de se limitar a uma visão de gateway de API de microsserviços, embora seja o que se poderia chamar a “visão clássica de um gateway de API”.

Você também pode olhar para um gateway API de uma forma mais arquitetônica e vê-lo como um padrão de design. Podemos dizer que o padrão de gateway API é duplo, pois na verdade corresponde a dois padrões clássicos de design Gang of Four: o adaptador e a fachada.

Como um adaptadorpermite a comunicação e colaboração, mesmo que as interfaces sejam incompatíveis.

Como um fachada, Um gateway de API encapsula a arquitetura interna da aplicação e fornece uma API aos seus clientes.

Tanto na visão dos microserviços como na visão arquitetônica, o API gateway tem sempre um papel de orquestração e, no final, deve estar lá para que as coisas funcionem sem problemas. Mas como se pode passar dos conceitos e definições aos resultados?

Vamos analisar os aspectos mais práticos e ver como podemos obter resultados.

Para isso, usaremos um gateway API específico, nosso próprio gateway de integração chamado Connect Bridge. Pense no Connect Bridge como um ponto de entrada único que “fala” SQL. Isto significa que, seja qual for o código utilizado (e pode optar por qualquer linguagem de programação), este comunicará com esta API gateway como se fosse uma base de dados, através das instruções CRUD normais: SELECT, INSERT, UPDATE, DELETE.

O Connect Bridge tem um “tradutor” (a que chamamos “conetor”) para cada aplicação que queremos aceder através da API. Este conetor traduz efetivamente as instruções SQL em chamadas API.

Ao utilizar Connect Bridge, precisará de menos código (muito menos - a redução pode chegar a 90%, dependendo do projeto), o código será mais fácil de compreender e testar e reduzirá significativamente o número de erros.

O engraçado é que quando se está a trabalhar com o Connect Bridge, o facto de usar SQL vai fazer com que se pense que se está a trabalhar com a base de dados do sistema alvo, por exemplo, a base de dados do Microsoft Exchange. Mas não se preocupe, não está, e a integridade da base de dados está segura - é um gateway e está sempre a aceder ao sistema alvo através da sua API.

Passo-a-passo com Connect Bridge como gateway API

1. Código da sua nova ou antiga aplicação
2. Instruções CRUD em SQL padrão acessando o sistema de destino como se fosse uma base de dados
3. Connect Bridge traduz SQL em chamadas API
4. Para cada sistema de destino estas traduções são realmente tratadas por um conector

Uma nota sobre qual linguagem de programação você pode usar com Connect Bridge. Como eu mencionei, você pode usar praticamente qualquer linguagem de programação.

Você só precisa ter certeza de que ele apóia ODBC, JDBCou Serviços Web. Desde que o faça, estás pronto para ir.

Por exemplo, digamos que quer utilizar Java. Muito bem, então pode gerar uma cadeia de ligação JDBC, e aí tem um gateway de API Java.

Quer utilizar o Node.js? Isso também é bom, pode gerar uma Cadeia de Ligação de Serviços Web e tem o seu gateway de API Node.js.

Eu poderia continuar, mas acho que você já entendeu: você pode ir em frente e usar sua linguagem de programação favorita.

O Connect Bridge é uma ferramenta paga, com preços que variam em função do número e do tipo de conectores utilizados e do número de utilizadores. Para que tenha uma ideia geral do custo desta API gateway, podemos dizer-lhe que os preços começam em 150€/mês. Para mais pormenores sobre os preços, consulte aqui. Recomendamos que você mesmo o experimente com o avaliação gratuita primeiro e desta forma você pode ter uma idéia de quais serão os ganhos de produtividade.

Em termos de ROI, você também deve considerar que a porta de entrada garante a solução final continua a funcionar mesmo quando o sistema alvo é actualizado sem qualquer alteração ao código que escreveste. Todos os problemas serão tratados pela porta de entrada.

Para o acompanhar nos primeiros passos com o Connect Bridge, vamos precisar de um sistema de destino de exemplo. Escolheremos o Microsoft SharePoint para isso, mas pode ser muitos outros.

1. Solicite um avaliação gratuita.
2. Instale Connect Bridge.
3. Manusear a configuração usando o Connect Bridge Management Studio:
   • A autenticação da API gateway tem dois passos. Para se conectar ao SharePoint, os usuários precisam se conectar ao Connect Bridgee depois Connect Bridge precisa de se ligar ao SharePoint.
     • Adicione uma conta para o SharePoint (Contas - Adicionar conta). Necessitará das suas credenciais SharePoint.
     • Permitir que o usuário Administrador padrão utilize essa conta ou criar um novo usuário e permitir que esse usuário utilize a conta SharePoint.
   • o Clique na opção Nova Consulta e, em seguida, no Navegador de Conexão. Localize o Conector SharePoint e abra até chegar ao DefaultConnection. Clique com o botão direito do mouse sobre ele e selecione Get Connection String. Em seguida, copie a string de conexão apropriada. Você vai precisar dela para o seu código.

Use a opção Nova Consulta para testar uma consulta que irá obter os dados que você precisa do SharePoint. Iremos com um exemplo de consulta aqui, ainda assim, a consulta deve ser ajustada para você o que você deseja do SharePoint.

Depois de selecionar a opção Nova Consulta, abra o Navegador de Conexão.

1. Localize o conetor SharePoint e abra-o até ver a opção Tables (Tabelas). Poderá ver que o esquema contém uma “tabela” chamada Site_Pages.
2. Nós podemos usar a consulta SELECT UniqueId, ContentType, Created, Modified, ContentVersion FROM Site_Pages LIMIT 10;
   Isto irá selecionar as primeiras 10 entradas da lista de Páginas do Site do SharePoint.

Por favor, note que embora pareça que estamos usando uma base de dados diretamente, não é o caso de forma alguma. Connect Bridge está a aceder apenas à API e depois a apresentar os dados como se tivessem vindo de uma base de dados. Sinta-se à vontade para explorar um pouco aqui. Você também pode explorar os procedimentos armazenados disponíveis. Assim que você tiver sua consulta, copie-a, pois você precisará dela no seu código.

Também é importante notar que, neste momento, você está apenas testando as coisas. Você pode pensar no Connect Bridge Management Studio como seu playground. Assim que estiver satisfeito com a consulta que recebeu, basta usá-lo no seu código, como se estivesse a aceder a uma base de dados. É bastante simples.

Para informações mais detalhadas, você pode verificar a documentação da API gateway que você receberá quando receber o seu avaliação gratuita. Você também pode verificar os logs da API gateway, o que no Connect Bridge é feito facilmente usando Connect Bridge Management Studio usando a opção Centro de Administração - Sistema - Logs na barra de navegação.

O conceito de API gateway pode parecer muito teórico no início, no entanto, não é difícil visualizar os benefícios uma vez que você se concentra em uma ferramenta específica como o Connect Bridge.

• O acesso é centralizado no API gateway, independentemente do número de sistemas alvo
• Não ter que aprender nenhuma nova API ou linguagem de programação pode reduzir erros e melhorar a produtividade
• A manutenção também é centralizada e isolada - está tudo no lado da API gateway e não no seu código, com compatibilidade com a frente garantida para cada sistema alvo pelo próprio Connect Bridge (e na verdade também compatibilidade com a retaguarda caso você precise dela)

Se você tiver algum comentário ou sugestão, escreva-os no formulário abaixo e nós responderemos o mais rápido possível.