Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację
Apigee X. info
Przykłady interfejsu Apigee Edge API zawierają przykładowe proxy interfejsów API, zasady, kod i narzędzia, które ilustrują możliwości usług Apigee Edge API opisanych poniżej.
Instrukcje korzystania z przykładów znajdziesz w artykule Korzystanie z przykładowych proxy interfejsów API.
Nauka przez działanie
Chcesz szybko zacząć pracę i zbudować solidną bazę wiedzy o Apigee Edge? W GitHubie mamy bibliotekę przykładów "learn-edge", które umożliwiają szybkie wdrażanie, wywoływanie, i śledzenie niektórych przykładowych proxy. Zacznij od najprostszego proxy i przejdź do proxy które ilustrują sprawdzanie klucza API, limit, buforowanie odpowiedzi, obsługę błędów i inne funkcje.
Po sklonowaniu repozytorium i skonfigurowaniu środowiska (co zajmuje tylko kilka minut) możesz wypróbować każdy przykład w mniej niż minutę. Każdy przykład tworzy nową wersję tego samego proxy, więc w środowisku nie będzie zbyt wielu przykładów. W każdej chwili możesz przełączać wersje, ponownie wdrażać inną wersję w interfejsie zarządzania i sprawdzać kod proxy. Plik readme każdego przykładu zawiera też krótkie podsumowanie tego, co robi przykład i jak jest skonfigurowany.
Wypróbuj! https://github.com/apigee/api-platform-samples/tree/master/learn-edge
Przykłady z przewodnika
Dostępny jest zestaw przykładów dotyczących tematów z przewodnika po proxy interfejsów API.
| Nazwa | Opis | Typy zasad | Zasoby |
|---|---|---|---|
| javascript-cookbook | Pokazuje prosty fragment kodu JavaScript, który dodaje nagłówki HTTP z zmiennych, przekształca raport pogodowy w formacie XML z JSON na XML i przycina treść dla klientów mobilnych. | minimize.js setHeaders.js |
|
| javascript-mashup-cookbook | Kompletna aplikacja JavaScript, która wywołuje publiczne interfejsy API, łączy wyniki i generuje rozszerzoną odpowiedź dla aplikacji klienckiej. (Uwaga: to proxy interfejsu API implementuje tę samą funkcję co policy-mashup, co pokazuje, że ten sam problem można rozwiązać za pomocą różnych technik). | JavaScript | MashItUp.js |
| java-hello | Proste wywołanie Javy „hello world”. | JavaCallout | JavaHello.java |
| java-cookbook | Przekształca treść i nagłówki odpowiedzi na wielkie litery. | JavaCallout |
ResponseUppercase.java |
| java-properties | Pokazuje, 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 Javy. | JavaCallout | JavaError.java |
| policy-mashup-cookbook | Kompletna aplikacja, która używa kompozycji zasad do wywoływania 2 publicznych interfejsów API, łączy wyniki i generuje rozszerzoną odpowiedź dla aplikacji klienckiej. (Uwaga: to proxy interfejsu API implementuje tę samą funkcję co javascript-mashup, co pokazuje, że ten sam problem można rozwiązać za pomocą różnych technik). | AssignMessage ServiceCallout ExtractVariables Javascript XMLToJSON |
GenerateResponse.js |
Przykładowe proxy interfejsów API
Te proxy interfejsów API znajdują się w GitHubie, gdzie na stronach readme znajdziesz szczegółowe opisy przykładów. Jeśli interesuje Cię, jak działa konkretna zasada w przykładzie, w kolumnie Typy zasad poniżej znajdź interesującą Cię zasadę, a następnie kliknij nazwę przykładu 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 przewodnika i przykładowych proxy w tabelach powyżej przykłady Edge GitHub zawierają też te zasoby:
| Nazwa | Opis | Typy zasad | Zasoby |
|---|---|---|---|
| regex-protection | Zasada ochrony przed zagrożeniami związanymi z wyrażeniami regularnymi może chronić backendowe interfejsy API i mikrousługi przed atakami typu SQL injection. | Nie dotyczy | |
| oauth-validate-key-secret | Implementujesz proces przyznawania hasła OAuth. Zanim wywołasz zewnętrznego dostawcę tożsamości w celu sprawdzenia danych logowania użytkownika, musisz sprawdzić klucz i tajny klucz klienta aplikacji w Edge. | OAuthV2, inne | Nie dotyczy |
| condition-pattern-matching | To proxy umożliwia łatwe wypróbowanie i testowanie instrukcji warunkowych w procesie proxy interfejsu API flow. | AssignMessage | Nie dotyczy |
| access-entity | Pokazuje, jak pobierać profile encji z magazynu danych Apigee Edge. | AssignMessage AccessEntity ExtractVariables |
brak |
| apikey | Implementuje proste sprawdzanie klucza API. | VerifyAPIKey AssignMessage Quota |
brak |
| async-callout | Pokazuje proste wywołanie asynchroniczne za pomocą klienta JavaScript httpClient. | JavaScript | assemble_response.js callout.js |
| base64encoder | Pokazuje, jak wywoływać pliki JavaScript z zasobów JavaScript w proxy interfejsów 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 wykonuje skrypt Pythona, który dodaje do wiadomości odpowiedzi zestaw danych o skuteczności jako nagłówki HTTP. | Skrypt (Python) | timer.py |
| dynamic-endpoint | Implementuje proste routing warunkowy w nieco bardziej złożonym scenariuszu, który definiuje 2 adresy URL i 1 trasę domyślną. | brak | brak |
| jira-release-notes | Jest to proxy interfejsu API używane przez zespół dokumentacji Apigee do generowania informacji o wersji z Jiry. | JSONToXML XSL |
releasenotes_api.xsl |
| kerberos-credential-mediation | Ten przykład pokazuje, jak przeprowadzić mediację poświadczeń Kerberosa w Apigee Edge. | JavaCallout | Plik JAR Javy |
| oauth-advanced | Kompletny, działający przykład procesu przyznawania kodu autoryzacji, w którym Apigee Edge pełni rolę serwera autoryzacji. |
GenerateAccessToken Wiele innych... |
zobacz przykładowy kod |
| oauth-client-credentials | Pokazuje w pełni funkcjonalny punkt końcowy tokena OAuth 2.0 skonfigurowany pod kątem przyznawania poświadczeń klienta. | GenerateAccessToken | brak |
| oauth-login-app | Rola wycofana. Zamiast tego zalecamy zapoznanie się z przykładem oauth-advanced. | ||
| oauth-validate-key-secret | Ilustruje technikę sprawdzania klucza i tajnego klucza klienta przed wywołaniem dostawcy tożsamości w celu sprawdzenia danych logowania użytkownika w procesie przyznawania hasła. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
brak |
| oauth-verify-accesstoken | Pokazuje proxy interfejsu API skonfigurowane do sprawdzania tokenów dostępu OAuth 2.0 i weryfikowania limitu. | VerifyAccessToken Quota |
brak |
| oauth10a-3legged | Pokazuje konfigurację OAuth 1.0a z 3 stronami. | GenerateAceessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
brak |
| outbound-oauth | Używa interfejsu Microsoft Azure Translator API do tłumaczenia tweetów. W tym celu wykonuje wywołanie wychodzące, aby uzyskać token dostępu OAuth, a następnie buforuje token za pomocą zasad buforowania usług API , ponownie używając buforowanego tokena za każdym razem, gdy jest wykonywane wywołanie wychodzące. Zawiera też przykładową aplikację przeglądarki używaną do wywoływania proxy interfejsu API. | AssignMessage LookupCache PopulateCache Javascript |
api-config.js api-token-get.js translate-query.js translate-results.js |
| pagination | Dzieli wiadomość odpowiedzi XML na strony na podstawie parametrów limitu i przesunięcia podanych przez klienta. | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
| response-cache | Pokazuje, jak buforować prognozy pogody w Edge przez 10 minut. | ResponseCache AssignMessage |
brak |
| simple-python | Pokazuje prosty scenariusz dołączania skryptu Pythona w odpowiedzi, który dodaje do niej wartość nagłówka. |
Skrypt (Python) | setHeader.py |
| soap | Pokazuje transformację XSL, która przepisuje plik WSDL w odpowiedzi na żądanie z parametrem zapytania ?wsdl. | AssignMessage ExtractVariables Script (Python) XSL |
calculateaddress.py fixwsdl.xsl |
| streaming | Pokazuje konfigurację przesyłania strumieniowego HTTP. | brak | brak |
| target-reroute | Pokazuje, jak używać JavaScript do dynamicznego wybierania docelowego adresu URL na podstawie treści wiadomości żądania. | ExtractVariables Javascript |
rewriteTargetUrl.js |
| twitter-mobile-timeline | Pokazuje, jak używać JavaScript do usuwania niepotrzebnych parametrów z tweetów, co pozwala 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 osi czasu (np. z statuses/user_timeline.json) w odpowiedź oEmbed która zawiera dane osi czasu jako bogatą treść HTML. | AssignMessage JavaScript |
search-oembed.js |
| variables | Pokazuje, jak wyodrębniać i ustawiać zmienne na podstawie treści wiadomości transportowych oraz wiadomości JSON i XML message content. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
| xmltojson | Przekształca dane odpowiedzi z XML na JSON. | XMLToJSON JSONToXML |
brak |
|
|
Pliki schematu XML, których możesz używać jako odniesienia podczas konfigurowania proxy interfejsów API, zasad, produktów 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 migawek organizacji pobiera ustawienia organizacji, w tym deweloperów, produkty API, hosty wirtualne, mapy klucz-wartość itp. Można go używać do tworzenia kopii zapasowych szczegółów organizacji lub do odkrywania ustawień w organizacji. |
Apigee-127
Jeśli jesteś programistą, Apigee-127 umożliwia szybkie rozpoczęcie kodowania proxy interfejsów API za pomocą Node.js i Swaggery. Przykłady a127 znajdziesz też w GitHubie: https://github.com/apigee-127/a127-samples.
Podziel się wrażeniami
Podziel się swoimi doświadczeniami na forum dla deweloperów Apigee.