Você está lendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. info
O Apigee Edge permite criar APIs RESTful com facilidade e rapidez, que podem ser consumidas pelos desenvolvedores de apps. Você expõe APIs no Edge criando proxies de APIs que funcionam como "fachadas" gerenciadas para serviços de back-end. Neste tópico, discutimos a relação entre APIs e proxies de API no Apigee Edge.
Vídeo: veja este vídeo curto para uma introdução aos proxies da API proxies.
O que é uma API?
Uma API é uma interface que facilita que um aplicativo consuma recursos ou dados de outro aplicativo. Ao definir pontos de entrada estáveis e simplificados para a lógica e os dados do aplicativo, as APIs permitem que os desenvolvedores acessem e reutilizem facilmente a lógica do aplicativo criada por outros desenvolvedores. No caso de "Web APIs", essa lógica e dados são expostos na rede.
Como os aplicativos que consomem APIs são sensíveis às alterações, as APIs também implicam um "contrato" O contrato fornece algum nível de garantia de que, com o tempo, a API mudará de maneira a previsível.
Com o Apigee Edge, você pode criar APIs e, se já tiver APIs, expô-las diretamente, e adicionar uma camada de gerenciamento e visibilidade. Se você tiver serviços ativados para HTTP, como serviços da Web baseados em SOA, eles também poderão ser expostos como APIs via Apigee Edge.
O Edge também permite que você crie APIs implementando aplicativos hospedados na plataforma de serviços de API , sem a necessidade de serviços de back-end. É possível criar esses aplicativos em JavaScript, Java, e Node.js.
O que é um proxy de API?
Você expõe APIs no Apigee Edge implementando proxies das APIs. Os proxies das APIs dissociam os serviços de back-end da API do app, protegendo esses apps das mudanças de códigos do back-end. Quando você faz mudanças de back-end nos seus serviços, os apps continuam a chamar a mesma API, sem qualquer interrupção.
Em uma configuração de proxy de API, há dois tipos de endpoints:
- ProxyEndpoint: define como os aplicativos cliente consomem suas APIs. Configure o ProxyEndpoint para definir o URL do proxy de API. O endpoint do proxy também determina se os aplicativos acessam o proxy de API por HTTP ou HTTPS. Geralmente, você anexa políticas ao ProxyEndpoint para impor segurança, verificações de cota e outros tipos de controle de acesso e limitação de taxa.
- TargetEndpoint: define a maneira como o proxy de API interage com seus serviços de back-end. Você configura o TargetEndpoint para encaminhar solicitações para o serviço de back-end apropriado, incluindo a definição de todas as configurações de segurança, o protocolo HTTP ou HTTPS e outras informações de conexão. Você pode anexar políticas ao TargetEndpoint para garantir que as mensagens de resposta sejam formatadas corretamente para o aplicativo que fez a solicitação inicial.
Você pode visualizar proxies de API como mostrado na imagem abaixo:
Como criar um proxy de API?
Um proxy de API consiste em um pacote de arquivos de configuração XML e código (como JavaScript e Java). A Apigee fornece várias maneiras para criar proxies de API, incluindo:
- Como usar a interface de gerenciamento do Edge para definir um proxy de API em uma interface gráfica do usuário (GUI, na sigla em inglês). Para mais informações, consulte Criar um proxy de API simples.
- Como criar arquivos XML, junto com outros arquivos de suporte, que definem o proxy de API e importar para o Edge.
- Como usar a API de gerenciamento do Edge para criar seus proxies de API fazendo uma série de solicitações REST para o Edge.
- Como implantar um aplicativo Node.js como um proxy. Consulte Como implantar um app Node.js independente.
O que é uma política?
Com o Edge, você controla o comportamento da API usando políticas , sem precisar escrever código. Uma política é como um módulo que implementa uma função de gerenciamento específica e limitada como parte do fluxo de solicitação/resposta do proxy. As políticas são projetadas para você adicionar tipos comuns de recursos de gerenciamento para uma API com facilidade e segurança. As políticas fornecem recursos como segurança, limitação de taxa, transformação e recursos de mediação, evitando que você precise codificar e manter essa funcionalidade por conta própria.
Criar seu primeiro proxy de API
O Apigee fornece um conjunto de tutoriais que você pode usar para criar sua primeira API. Comece com a opção Criar seu primeiro proxy de API.
Uma ótima maneira de aprender sobre proxies de API é trabalhar com as amostras, conforme descrito em Como usar os proxies de API de amostra.