Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Konfiguracja ProxyEndpoint określa sposób, w jaki aplikacje klienckie korzystają z interfejsów API za pomocą Apigee Edge. Parametr ProxyEndpoint określa adres URL serwera proxy interfejsu API oraz sposób jego działania: jakie zasady należy zastosować, do których punktów końcowych kierować ruch oraz jakie warunki muszą zostać spełnione, aby te zasady lub reguły kierowania mogły zostać wykonane.
Krótko mówiąc, konfiguracja ProxyEndpoint określa wszystko, co trzeba zrobić, aby wdrożyć interfejs API.
antywzorzec
Pośrednik interfejsu API może mieć co najmniej 1 punkt końcowy. Zdefiniowanie wielu punktów końcowych serwera proxy to prosty mechanizm implementowania wielu interfejsów API w jednym serwerze proxy. Dzięki temu możesz ponownie używać zasad lub logiki biznesowej przed wywołaniem punktu końcowego docelowego i po nim.
Z drugiej strony, definiując wiele punktów końcowych proxy w jednym interfejsie API proxy, skończysz w koncepcji łącząc wiele niepowiązanych interfejsów API w jeden element. Utrudnia to odczytywanie, interpretowanie, debugowanie i utrzymywanie serwerów proxy interfejsu API. To sprzecza z główną ideą serwerów proxy interfejsów API: ułatwiania programistom tworzenia i utrzymywania interfejsów API.
Wpływ
Wiele punktów końcowych proxy w proxy interfejsu API może:
- utrudnić deweloperom zrozumienie i obsługę proxy API;
- zafałszować dane analityczne. Domyślnie dane analityczne są agregowane na poziomie serwera proxy. Dane nie są rozbijane według punktów końcowych proxy, chyba że utworzysz raporty niestandardowe.
- utrudnić rozwiązywanie problemów z serwerami proxy API;
Sprawdzona metoda
Podczas wdrażania nowego serwera proxy interfejsu API lub przeprojektowywania istniejącego serwera proxy interfejsu API stosuj te sprawdzone metody:
- Zaimplementuj 1 proxy interfejsu API z 1 adresem ProxyEndpoint.
- Jeśli masz kilka interfejsów API, które korzystają z wspólnego serwera docelowego lub wymagają tej samej logiki przed wywołaniem serwera docelowego lub po jego wywołaniu, rozważ użycie wspólnych przepływów do implementowania tej logiki w różnych serwerach proxy interfejsu API.
- Jeśli masz kilka interfejsów API, które mają wspólny początkowy ścieżkę podstawową, ale różnią się sufiksem, użyj przepływów warunkowych w jednym punkcie końcowym proxy.
- Jeśli istnieje serwer proxy interfejsu API z wieloma punktami końcowymi serwera proxy i nie ma z nim żadnych problemów, nie musisz podejmować żadnych działań.
Używanie jednego punktu końcowego proxy na interfejs proxy API powoduje:
- Proste i łatwe w utrzymaniu proxy
- W Analytics będą dostępne lepsze informacje, np. dotyczące wydajności serwera proxy i docelowego czasu odpowiedzi, które będą raportowane osobno, a nie łączone dla wszystkich punktów końcowych serwera proxy.
- szybsze rozwiązywanie problemów i ich wykrywanie;