Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Przykłady interfejsów API Apigee Edge zawierają przykładowe serwery proxy API, zasady, kod i narzędzia, które obrazują możliwości usług interfejsu API Apigee Edge opisane poniżej.
Instrukcje dotyczące korzystania z przykładów znajdziesz w artykule Używanie przykładowych serwerów proxy API.
Ucz się, wykonując zadania
Chcesz szybko zacząć budować solidną bazę wiedzy na temat Apigee Edge? Na GitHub mamy bibliotekę przykładów „learn-edge”, które umożliwiają szybkie wdrażanie, wywoływanie i śledzenie przykładowych serwerów proxy, począwszy od najprostszego serwera proxy, a na tych, które ilustrują weryfikację klucza API, limity, buforowanie odpowiedzi, obsługę błędów i inne, kończąc.
Po skopiowaniu repozytorium i skonfigurowaniu środowiska (co zajmuje kilka minut) możesz wypróbować każdą próbkę w mniej niż minutę. Ponieważ każda próbka tworzy nową wersję tego samego serwera proxy, Twoje środowisko nie będzie zaśmiecone dużą liczbą próbek. W każdej chwili możesz: przełączać wersje, ponownie wdrażać inną wersję w interfejsie zarządzania i sprawdzać kod pośredniczący. Plik readme dla każdej próbki zawiera też krótki opis tego, co ona robi i jak jest skonfigurowana.
Wypróbuj to. https://github.com/apigee/api-platform-samples/tree/master/learn-edge
Przykłady książek kucharskich w Dokumentach
W tematach dotyczących poradnika proxy interfejsu API podano zestaw przykładów.
Nazwa | Opis | Typy zasad | Zasoby |
---|---|---|---|
javascript-cookbook | Przykładowy prosty fragment kodu JavaScript, który dodaje nagłówki HTTP z użyciem zmiennych, przekształca raport pogodowy w formacie XML z formatu JSON na XML i skraca zawartość dla klientów mobilnych. | minimize.js setHeaders.js |
|
javascript-mashup-cookbook | Pełna aplikacja JavaScript, która wywołuje publiczne interfejsy API, łączy wyniki i generuje rozszerzoną odpowiedź dla aplikacji klienta. (Uwaga: to rozwiązanie typu proxy API implementuje tę samą funkcjonalność co mashup zasad, co pokazuje, że ten sam problem można rozwiązać, stosując różne techniki). | Javascript | MashItUp.js |
java-hello | Prosty przykład wywołania w Javie. | JavaCallout | JavaHello.java |
java-cookbook | Zawartość i nagłówki odpowiedzi są zamieniane na wielkie litery. | JavaCallout |
ResponseUppercase.java |
java-properties | Film pokazujący, jak używać właściwości w wywołaniu Javy. | JavaCallout | JavaProperties.java |
java-error | Pokazuje wzorce obsługi błędów, których możesz używać w kodzie wywołania w języku Java. | JavaCallout | JavaError.java |
policy-mashup-cookbook | Pełna aplikacja, która używa kompozycji zasad do wywołania 2 publicznych interfejsów API, łączy wyniki i generuje wzbogaconą odpowiedź dla aplikacji klienckiej. (Uwaga: to wywołanie interfejsu API przez proxy udostępnia te same funkcje co skrypt JavaScript, co pokazuje, że ten sam problem można rozwiązać, stosując różne techniki). | AssignMessage ServiceCallout ExtractVariables Javascript XMLToJSON |
GenerateResponse.js |
Przykładowe proxy interfejsu API
Te proxy API znajdują się na GitHub, gdzie na stronach readme znajdziesz szczegółowe opisy przykładów. Jeśli chcesz sprawdzić, jak działa dana zasada w próbce, odszukaj ją w kolumnie Typy zasad, a potem kliknij nazwę próbki w kolumnie Nazwa. (zasady są połączone z odpowiednimi stronami referencyjnymi w dokumentacji).
Materiały referencyjne i narzędzia
Oprócz przykładów z książki kucharskiej Dokumentów i przykładowych proxy w tabelach powyżej GitHub Edge Examples zawiera też te zasoby:
Nazwa | Opis | Typy zasad | Zasoby |
---|---|---|---|
regex-protection | Zasady ochrony przed zagrożeniami oparte na wyrażeniach regularnych mogą chronić interfejsy API i mikroserwisy backendu przed atakami typu SQL injection. | Nie dotyczy | |
oauth-validate-key-secret | wdrażasz proces przyznawania dostępu typu hasło OAuth. Przed wywołaniem zewnętrznego dostawcy tożsamości w celu zweryfikowania danych logowania użytkownika musisz zweryfikować klucz klienta aplikacji i tajny klucz aplikacji w Edge. | OAuthV2, inne | Nie dotyczy |
condition-pattern-matching | Ten serwer pośredniczący umożliwia łatwe testowanie instrukcji warunkowych w przepływie serwera pośredniczącego API. | AssignMessage | Nie dotyczy |
access-entity | Pokazuje, jak pobierać profile elementów z bazy danych Apigee Edge. | AssignMessage AccessEntity ExtractVariables |
brak |
apikey | Implementuje prostą weryfikację klucza interfejsu API. | VerifyAPIKey AssignMessage Quota |
brak |
async-callout | Przykład prostego wywołania asynchronicznego za pomocą JavaScript httpClient. | Javascript | assemble_response.js callout.js |
base64encoder | Pokazuje, jak wywoływać include JavaScriptu z zasobów JavaScriptu w interfejsach proxy interfejsu API. | AssignMessage Javascript |
core-min.js enc-utf16-min.js enc-base64-min.js encodeAuthHeader.js |
conditional-policy | Implementuje proste egzekwowanie zasad warunkowych. Gdy żądanie zawiera nagłówek HTTP responsetime:true, zasada uruchamia skrypt Pythona, który dodaje do wiadomości o odpowiedzi zestaw danych o wydajności w postaci nagłówków HTTP. | Skrypt (Python) | timer.py |
dynamic-endpoint | Wdrożenie prostego przekierowywania warunkowego w nieco bardziej złożonym scenariuszu, który definiuje 2 adresy URL i 1 trasę domyślną. | brak | brak |
jira-release-notes | To serwer proxy interfejsu API używany przez zespół ds. dokumentacji Apigee do generowania informacji o wersji z Jira. | JSONToXML XSL |
releasenotes_api.xsl |
kerberos-credential-mediation | Ten przykład pokazuje, jak przeprowadzić zapośredniczenie danych uwierzytelniających Kerberos w Apigee Edge. | JavaCallout | Plik JAR Javy |
oauth-advanced | Pełny, działający przykład przepływu typu udzielania dostępu za pomocą kodu autoryzacji z Apigee Edge jako serwerem autoryzacji. |
GenerateAccessToken i wiele innych. |
zapoznać się z przykładowym kodem |
oauth-client-credentials | Pokazuje w pełni funkcjonalny punkt końcowy tokena OAuth 2.0 skonfigurowany pod kątem typu udzielenia uprawnień danych logowania klienta. | GenerateAccessToken | brak |
oauth-login-app | Rola wycofana. Zalecamy zapoznanie się z tym przykładem: oauth-advanced. | ||
oauth-validate-key-secret | Przykład techniki weryfikacji klucza i klucza tajnego klienta przed wywołaniem dostawcy tożsamości w celu weryfikacji danych logowania użytkownika w ramach procesu udzielania dostępu typu hasło. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
brak |
oauth-verify-accesstoken | Przykład serwera proxy API skonfigurowanego do sprawdzania tokenów dostępu OAuth 2.0 i weryfikacji limitu. | VerifyAccessToken Limit |
brak |
oauth10a-3legged | Demonstracja konfiguracji OAuth 1.0a z 3 etapami. | GenerateAceessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
brak |
outbound-oauth | Do tłumaczenia tweetów używa interfejsu Microsoft Azure Translator API. W tym celu wykonuje wywołanie wychodzące, aby uzyskać token dostępu OAuth, a następnie przechowuje go w pamięci podręcznej przy użyciu zasad dotyczących pamięci podręcznej usług interfejsu API. Wykorzystuje ten token za każdym razem, gdy wykonuje wywołanie wychodzące. Zawiera też demonstracyjną aplikację przeglądarki, która służy do wywoływania proxy interfejsu API. | AssignMessage LookupCache PopulateCache Javascript |
api-config.js api-token-get.js translate-query.js translate-results.js |
podział na strony | dzieli na strony odpowiedź w formacie XML na podstawie parametrów limit i offset podanych przez klienta; | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
response-cache | Pokazuje, jak przechowywać w pamięci podręcznej prognozy pogody w Edge przez 10 minut. | ResponseCache AssignMessage |
brak |
simple-python | Przykład prostego scenariusza polegającego na dołączeniu skryptu Pythona do odpowiedzi , który dodaje do niej wartość nagłówka. |
Skrypt (Python) | setHeader.py |
mydło | Przykład przekształcenia XSL, które w odpowiedzi na żądanie z parametrem zapytania ?wsdl przepisuje plik WSDL. | AssignMessage ExtractVariables Skrypt (Python) XSL |
calculateaddress.py fixwsdl.xsl |
streaming | Przykład konfiguracji strumieniowania HTTP. | brak | brak |
target-reroute | Przykład użycia kodu JavaScript do dynamicznego wybierania adresu URL docelowego na podstawie treści wiadomości z prośbą. | ExtractVariables Javascript |
rewriteTargetUrl.js |
twitter-mobile-timeline | Pokazuje, jak za pomocą JavaScripta usuwać z tweetów niepotrzebne parametry, dzięki czemu można uzyskać uproszczoną oś czasu Twittera, która jest przyjazna dla urządzeń mobilnych o ograniczonych zasobach. | AssignMessage Javascript |
MobileTimeline.js |
twitter-oembed | Przekształca odpowiedzi z osi czasu (np. z statuses/user_timeline.json) w odpowiedź o formie oEmbed, która zawiera dane z osi czasu jako rozszerzoną treść HTML. | AssignMessage JavaScript |
search-oembed.js |
zmiennych, | Pokazuje, jak wyodrębniać i ustawiać zmienne na podstawie transportu oraz treści wiadomości w formacie JSON i XML. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
xmltojson | Konwertuje dane odpowiedzi z formatu XML na format JSON. | XMLToJSON JSONToXML |
brak |
|
pliki schematów XML, których możesz używać jako referencyjnych podczas konfigurowania serwerów proxy interfejsu API, zasad, produktów interfejsu API oraz profili deweloperów i aplikacji. |
||
|
Zawiera narzędzie do wdrażania (deploy.py), które importuje proxy interfejsu API do organizacji w Apigee Edge, a następnie wdraża je w określonym środowisku. |
||
|
Narzędzie do tworzenia kopii zapasowej organizacji umożliwia pobieranie ustawień organizacji, w tym informacji o deweloperach, usługach API, hostach wirtualnych, mapach klucz-wartość itp. Można go użyć do utworzenia kopii zapasowej szczegółów organizacji lub do sprawdzenia ustawień organizacji. |
Apigee-127
Jeśli jesteś programistą, Apigee-127 pomoże Ci zacząć kodować proksy API za pomocą Node.js i Swagger. Przykłady kodu a127 znajdziesz też na GitHubie: https://github.com/apigee-127/a127-samples.
Podziel się wrażeniami
Podziel się swoimi wrażeniami na forum dla deweloperów Apigee.