Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Apigee Edge umożliwia łatwe i szybkie tworzenie interfejsów API REST, z których mogą korzystać deweloperzy aplikacji. Interfejsy API udostępniasz na urządzeniach Edge, tworząc ich serwery proxy, które działają jako zarządzane „fasady” usług backendowych. W tym temacie omawiamy relację między interfejsami API a serwerami proxy interfejsów API w Apigee Edge.
Film: obejrzyj krótki film wprowadzający do serwerów proxy interfejsu API.
Co to jest interfejs API?
Interfejs API ułatwia jednej aplikacji korzystanie z funkcji lub danych innej aplikacji. Dzięki zdefiniowaniu stabilnych, uproszczonych punktów wejścia do logiki aplikacji i danych interfejsy API umożliwiają deweloperom łatwy dostęp do logiki aplikacji stworzonej przez innych programistów i jej ponowne wykorzystanie. W przypadku „interfejsów API w internecie” ta logika i dane są udostępniane w sieci.
Aplikacje, które korzystają z interfejsów API, są wrażliwe na zmiany, dlatego interfejsy API również wiążą się z „umową”. Umowa zapewnia pewien poziom pewności, że z czasem interfejs API będzie zmieniał się w przewidywalny sposób.
Apigee Edge umożliwia tworzenie interfejsów API, a jeśli już je masz, udostępnianie ich bezpośrednio, przy jednoczesnym dodaniu warstwy zarządzania i widoczności. Jeśli masz usługi obsługujące HTTP, takie jak usługi internetowe oparte na SOA, możesz je udostępnić jako interfejsy API za pomocą Apigee Edge.
Edge umożliwia też tworzenie interfejsów API przez implementowanie aplikacji hostowanych na platformie usług interfejsu API bez korzystania z usługi backendowej. Możesz tworzyć te aplikacje w JavaScript, Javie i Node.js.
Co to jest proxy interfejsu API?
Interfejsy API udostępniasz w usłudze Apigee Edge, wdrażając serwery proxy interfejsów API. Proxies interfejsu API odłączają interfejs API skierowany do aplikacji od usług backendowych, chroniąc aplikacje przed zmianami kodu backendu. Gdy wprowadzasz zmiany w backendzie swoich usług, aplikacje nadal wywołują ten sam interfejs API bez żadnych przerw.
W konfiguracji serwera proxy interfejsu API występują 2 typy punktów końcowych:
- ProxyEndpoint: określa sposób, w jaki aplikacje klienckie korzystają z Twoich interfejsów API. Aby zdefiniować adres URL serwera proxy interfejsu API, skonfiguruj punkt końcowy serwera proxy. Punkt końcowy serwera proxy określa też, czy aplikacje uzyskują dostęp do serwera proxy interfejsu API przez HTTP czy HTTPS. Zwykle do ProxyEndpoint dołączasz policies, aby egzekwować zabezpieczenia, sprawdzać limity i wykonywać inne rodzaje kontroli dostępu oraz ograniczać częstotliwość dostępu.
- TargetEndpoint: określa sposób, w jaki serwer proxy interfejsu API wchodzi w interakcje z usługami backendu. Konfigurujesz punkt końcowy docelowy, aby przekazywać żądania do odpowiedniej usługi backendu, w tym definiować ustawienia zabezpieczeń, protokół HTTP lub HTTPS oraz inne informacje o połączeniu. Możesz dołączyć policies do punktu końcowego docelowego, aby mieć pewność, że odpowiedzi będą miały prawidłowy format dla aplikacji, która wysłała pierwotne żądanie.
Proxy interfejsu API możesz wizualizować w ten sposób:
Jak utworzyć serwer proxy interfejsu API?
Serwer proxy interfejsu API składa się z pakietu plików konfiguracji XML i kodu (np. JavaScript i Java). Apigee udostępnia kilka sposobów tworzenia serwerów proxy interfejsu API, m.in.:
- Korzystanie z interfejsu zarządzania Edge do definiowania w GUI (graficznym interfejsie użytkownika) serwera proxy API. Więcej informacji znajdziesz w artykule Tworzenie prostego serwera proxy interfejsu API.
- Tworzenie plików XML wraz z innymi plikami pomocniczymi, które definiują serwer proxy interfejsu API, a następnie importowanie ich do przeglądarki Edge.
- Używanie interfejsu API do zarządzania Edge do tworzenia serwerów proxy interfejsu API przez wysyłanie serii żądań REST do Edge.
- Wdróż aplikację Node.js jako serwer pośredniczący. Zapoznaj się z artykułem Wdrażanie samodzielnej aplikacji Node.js.
Co to jest zasada?
Edge umożliwia sterowanie działaniem interfejsu API bez pisania kodu za pomocą policies. Zasady to moduły, które implementują określoną, ograniczoną funkcję zarządzania w ramach przepływu żądań i odpowiedzi. Zasady zostały zaprojektowane tak, aby umożliwić łatwe i bezpieczne dodawanie do interfejsu API typowych funkcji zarządzania. Zasady zapewniają takie funkcje jak bezpieczeństwo, ograniczanie szybkości, transformacja i mediacja, dzięki czemu nie musisz samodzielnie kodować ani utrzymywać tych funkcji.
Tworzenie pierwszego proxy interfejsu API
Apigee udostępnia zestaw samouczków, które pomogą Ci utworzyć pierwszy interfejs API. Zacznij od tworzenia pierwszego serwera proxy interfejsu API.
Aby dowiedzieć się więcej o interfejsach API, możesz skorzystać z przykładów opisanych w artykule Korzystanie z przykładowych interfejsów API.