Compreender as APIs e os proxies de API

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

O Apigee permite-lhe criar APIs RESTful de forma fácil e rápida que podem ser consumidas por programadores de apps. Expõe APIs no Apigee criando proxies de API que atuam como "fachadas" geridas para serviços de back-end. Este tópico aborda a relação entre as APIs e os proxies de API no Apigee.

Vídeo: veja este breve vídeo para uma introdução aos proxies de API.

O que é uma API?

Uma API é uma interface que facilita o consumo de capacidades ou dados de outra aplicação. Ao definir pontos de entrada estáveis e simplificados para a lógica de aplicação e os dados, as APIs permitem que os programadores acedam e reutilizem facilmente a lógica de aplicação criada por outros programadores. No caso das APIs Web, essa lógica e dados são expostos através da rede.

Uma vez que as aplicações que consomem APIs são sensíveis a alterações, as APIs também implicam um contrato. O contrato oferece algum nível de garantia de que, ao longo do tempo, a API vai mudar de forma previsível.

O Apigee permite-lhe criar APIs e, se já tiver APIs, expô-las diretamente, ao mesmo tempo que adiciona uma camada de gestão e visibilidade. Se tiver serviços ativados por HTTP, como serviços Web baseados em SOA, também podem ser expostos como APIs através do Apigee.

O Apigee também lhe permite criar APIs através da implementação de aplicações alojadas na plataforma API Services, sem envolver um serviço de back-end. Pode criar estas aplicações em JavaScript e Java.

O que é um proxy de API?

Expõe APIs no Apigee implementando proxies de API. Os proxies de API desassociam a API orientada para a app dos seus serviços de back-end, protegendo essas apps contra alterações ao código de back-end. À medida que faz alterações de back-end aos seus serviços, as apps continuam a chamar a mesma API sem interrupções.

Numa configuração de proxy de API, existem dois tipos de pontos finais:

  • ProxyEndpoint: define a forma como as apps cliente consomem as suas APIs. Pode configurar o ProxyEndpoint para definir o URL do seu proxy de API. O ponto final do proxy também determina se as apps acedem ao proxy da API através de HTTP ou HTTPS. Normalmente, anexa políticas ao ProxyEndpoint para aplicar a segurança, as verificações de quotas e outros tipos de controlo de acesso e limitação de taxas.
  • TargetEndpoint: define a forma como o proxy de API interage com os seus serviços de back-end. Configura o TargetEndpoint para encaminhar pedidos para o serviço de back-end adequado, incluindo a definição de quaisquer definições de segurança, protocolo HTTP ou HTTPS e outras informações de ligação. Pode anexar políticas ao TargetEndpoint para garantir que as mensagens de resposta estão formatadas corretamente para a app que fez o pedido inicial.

Pode visualizar proxies de API, conforme mostrado no gráfico abaixo:

Os pedidos HTTP entram através do ponto final de pedido de proxy, são transmitidos para o ponto final de pedido de destino e, em seguida, enviados para os serviços de back-end. As respostas HTTP entram através do ponto final de resposta de destino, são transmitidas para o ponto final de resposta do proxy e, em seguida, de volta para o cliente.

Tipos de proxy de API

O Apigee suporta dois tipos de proxy:

  • Os proxies padrão incluem apenas políticas padrão. Os proxies padrão são adequados para soluções de API simples e não podem ser incluídos em produtos de API.
  • Os proxies extensíveis incluem, pelo menos, uma política extensível ou um flow hook. Os proxies extensíveis podem incluir muito mais funcionalidades do que os proxies padrão.

Como é que se cria um proxy de API?

Um proxy de API consiste num pacote de ficheiros de configuração XML e código (como JavaScript e Java). A Apigee oferece várias formas de criar proxies de API, incluindo:

  • Usar a IU do Apigee para definir um proxy de API numa interface gráfica do utilizador (GUI). Para mais informações, consulte o artigo Crie um proxy de API simples.
  • Criar ficheiros XML, juntamente com quaisquer outros ficheiros auxiliares, que definam o proxy de API e, em seguida, importá-los para o Apigee.
  • Usando a API Apigee para criar os seus proxies de API fazendo uma série de pedidos REST ao Apigee.
  • Desenvolva localmente com o Apigee no VS Code e implemente como um arquivo. Para mais informações, consulte o artigo Vista geral do desenvolvimento local com o Apigee

O que é uma revisão do proxy de API?

As revisões do proxy de API oferecem um mecanismo simples para gerir as atualizações à configuração do proxy de API à medida que itera. As revisões são numeradas sequencialmente, o que lhe permite reverter uma alteração implementando uma revisão anterior do proxy de API. As revisões permitem implementar um proxy de API num ambiente de produção enquanto continua a criar novas revisões desse proxy de API num ambiente de teste. Quando estiver tudo pronto, pode promover a revisão superior do proxy da API do ambiente de teste para o ambiente de produção.

O que é uma política?

O Apigee permite-lhe controlar o comportamento da API sem escrever código através de políticas. Uma política é como um módulo que implementa uma função de gestão específica e limitada como parte do fluxo de pedido/resposta do proxy. As políticas são concebidas para lhe permitir adicionar tipos comuns de capacidades de gestão a uma API de forma fácil e fiável. As políticas oferecem funcionalidades como segurança, limitação de taxa, transformação e capacidades de mediação, o que lhe permite não ter de programar nem manter esta funcionalidade por conta própria.

Crie o seu primeiro proxy de API

A Apigee oferece um conjunto de tutoriais que pode usar para criar a sua primeira API. Comece por criar o seu primeiro proxy de API. Consulte também outros tópicos de introdução.

Saiba mais