Está a ver a documentação do Apigee e do Apigee Hybrid.
Veja a documentação do
Apigee Edge.
A configuração ProxyEndpoint define a forma como as apps cliente consomem as APIs através do Apigee. O ProxyEndpoint define o URL do proxy de API e como um proxy se comporta: que políticas aplicar e a que pontos finais de destino encaminhar, bem como as condições que têm de ser cumpridas para que estas políticas ou regras de encaminhamento sejam executadas.
Em resumo, a configuração do ProxyEndpoint define tudo o que tem de ser feito para implementar uma API.
Antipattern
Um proxy de API pode ter um ou mais pontos finais de proxy. A definição de vários ProxyEndpoints é um mecanismo fácil e simples para implementar várias APIs num único proxy. Isto permite-lhe reutilizar políticas e/ou lógica empresarial antes e depois da invocação de um TargetEndpoint.
Por outro lado, quando define vários ProxyEndpoints num único proxy de API, acaba por combinar conceptualmente muitas APIs não relacionadas num único artefacto. Torna os proxies de API mais difíceis de ler, compreender, depurar e manter. Isto contraria a filosofia principal dos proxies de API: facilitar a criação e a manutenção de APIs para os programadores.
Impacto
Vários ProxyEndpoints num proxy de API podem:
- Dificultar a compreensão e a manutenção do proxy de API por parte dos programadores.
- Obscure as estatísticas. Por predefinição, os dados de estatísticas são agregados ao nível do proxy. Não existe uma discriminação das métricas por ponto final do proxy, a menos que crie relatórios personalizados.
- Dificultar a resolução de problemas com proxies de API.
Prática recomendada
Quando estiver a implementar um novo proxy de API ou a reformular um proxy de API existente, use as seguintes práticas recomendadas:
- Implemente um proxy de API com um único ProxyEndpoint.
- Se existirem várias APIs que partilham um servidor de destino comum e/ou requerem a mesma lógica antes ou depois da invocação do servidor de destino, considere usar fluxos partilhados para implementar essa lógica em diferentes proxies de API.
- Se existirem várias APIs que partilham um caminho base de início comum, mas diferem no sufixo, use fluxos condicionais num único ProxyEndpoint.
- Se existir um proxy de API com vários ProxyEndpoints e não houver problemas com o mesmo, não é necessário tomar nenhuma medida.
A utilização de um ProxyEndpoint por proxy de API resulta no seguinte:
- Proxies mais simples e fáceis de manter
- As informações melhoradas no Analytics, como o desempenho do proxy e o tempo de resposta do destino, vão ser comunicadas separadamente em vez de agregadas para todos os ProxyEndpoints
- Resolução de problemas mais rápida