Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Apigee Edge API örnekleri, aşağıda açıklanan Apigee Edge API Hizmetleri'nin özelliklerini gösteren örnek API proxy'lerini, politikaları, kodu ve araçları içerir.
Örnekleri kullanma talimatları için Örnek API proxy'lerini kullanma başlıklı makaleyi inceleyin.
Uygulayarak öğrenme
Hemen işe koyulup Apigee Edge hakkında sağlam bir bilgi tabanı oluşturmaya başlamak mı istiyorsunuz? GitHub'da, en basit proxy'den başlayıp API anahtarı doğrulama, kota, yanıt önbelleğe alma, hata işleme ve daha fazlasını gösteren proxy'lere geçerek bazı örnek proxy'leri hızlı bir şekilde dağıtmanıza, çağırmanıza ve izlemenize olanak tanıyan bir "learn-edge" örnekleri kitaplığımız var.
Depoyu klonlayıp ortamınızı ayarladıktan sonra (bu işlem yalnızca birkaç dakika sürer) her örneği bir dakikadan kısa sürede deneyebilirsiniz. Ayrıca her örnek aynı proxy'nin yeni bir sürümünü oluşturduğundan ortamınız çok sayıda örnekle karışmaz. İstediğiniz zaman revizyonlar arasında geçiş yapabilir, yönetim kullanıcı arayüzünde farklı bir revizyonu yeniden dağıtabilir ve proxy koduna bakabilirsiniz. Her örneğin benioku dosyası, örneğin ne yaptığı ve nasıl ayarlandığı hakkında kısa bir özet de sunar.
Hemen deneyin! https://github.com/apigee/api-platform-samples/tree/master/learn-edge
Dokümanlar çözüm kitabı örnekleri
API proxy'si çözüm kitabı konuları için bir dizi örnek sağlanır.
| Ad | Açıklama | Politika Türleri | Kaynaklar |
|---|---|---|---|
| javascript-cookbook | Değişkenlerden HTTP üstbilgileri ekleyen, XML biçimli bir hava durumu raporunu JSON'dan XML'ye dönüştüren ve içeriği mobil istemciler için kısaltan basit bir JavaScript snippet'ini gösterir. | minimize.js setHeaders.js |
|
| javascript-mashup-cookbook | Herkese açık API'leri çağıran, sonuçları birleştiren ve istemci uygulaması için zenginleştirilmiş bir yanıt oluşturan eksiksiz bir JavaScript uygulaması. (Not: Bu API proxy'si, aynı işlevselliği politika birleştirme ile uygular ve aynı sorunun farklı teknikler kullanılarak çözülebileceğini gösterir.) | JavaScript | MashItUp.js |
| java-hello | Basit bir "Merhaba dünya" Java çağrısı. | JavaCallout | JavaHello.java |
| java-cookbook | Yanıt içeriğini ve başlıklarını büyük harfe dönüştürür. | JavaCallout |
ResponseUppercase.java |
| java-properties | Java açıklama metninde özelliklerin nasıl kullanılacağını gösterir. | JavaCallout | JavaProperties.java |
| java-error | Java Callout kodunda kullanabileceğiniz hata işleme kalıplarını gösterir. | JavaCallout | JavaError.java |
| policy-mashup-cookbook | İki herkese açık API'yi çağırmak için politika oluşturmayı kullanan, sonuçları birleştiren ve istemci uygulaması için zenginleştirilmiş bir yanıt oluşturan eksiksiz bir uygulama. (Not: Bu API proxy'si, JavaScript-mashup ile aynı işlevselliği uygular ve aynı sorunun farklı teknikler kullanılarak çözülebileceğini gösterir.) | AssignMessage ServiceCallout ExtractVariables Javascript XMLToJSON |
GenerateResponse.js |
Örnek API proxy'leri
Aşağıdaki API proxy'leri GitHub'da bulunur. Buradaki readme sayfalarında örneklerin ayrıntılı açıklamaları yer alır. Belirli bir politikanın örnekteki işleyiş şeklini öğrenmek istiyorsanız aşağıdaki Politika Türleri sütununda ilgilendiğiniz politikayı bulun ve Ad sütununda örnek adını tıklayın. (Politikalar, dokümanlardaki ilgili referans sayfalarına bağlanır.)
Referans ve Araçlar
Yukarıdaki tablolarda yer alan doküman çözüm kitabı örneklerine ve örnek proxy'lere ek olarak Edge GitHub örnekleri aşağıdaki kaynakları da içerir:
| Ad | Açıklama | Politika Türleri | Kaynaklar |
|---|---|---|---|
| regex-protection | Normal ifade tehdit koruması politikası, arka uç API'lerinizi ve mikro hizmetlerinizi SQL ekleme saldırılarına karşı koruyabilir. | Yok | |
| oauth-validate-key-secret | OAuth Şifre yetkilendirme türü akışını uyguluyorsunuz. Kullanıcının kimlik bilgilerini doğrulamak için harici bir kimlik sağlayıcıyı çağırmadan önce Edge'de hem uygulama istemci anahtarını hem de gizli anahtarı doğrulamanız gerekir. | OAuthV2, diğerleri | Yok |
| condition-pattern-matching | Bu proxy, bir API proxy'si akışındaki koşullu ifadeleri kolayca denemenize ve test etmenize olanak tanır. | AssignMessage | Yok |
| access-entity | Varlıklara ait profillerin Apigee Edge veri deposundan nasıl alınacağını gösterir. | AssignMessage AccessEntity ExtractVariables |
yok |
| apikey | Basit API anahtarı doğrulamasını uygular. | VerifyAPIKey AssignMessage Quota |
yok |
| async-callout | JavaScript httpClient kullanılarak basit bir asenkron çağrı gösterir. | JavaScript | assemble_response.js callout.js |
| base64encoder | API proxy'lerindeki JavaScript kaynaklarından JavaScript dahil etme işlemlerinin nasıl çağrılacağını gösterir. | AssignMessage Javascript |
core-min.js enc-utf16-min.js enc-base64-min.js encodeAuthHeader.js |
| conditional-policy | Basit koşullu politika yaptırımlarını uygular. Bir istekte HTTP header responsetime:true olduğunda bir politika, yanıta HTTP başlıkları olarak bir dizi performans metriği ekleyen bir Python komut dosyasını yürütür. | Komut dosyası (Python) | timer.py |
| dynamic-endpoint | İki URL ve bir varsayılan rota tanımlayan biraz daha karmaşık bir senaryoda basit koşullu yönlendirme uygular. | yok | yok |
| jira-release-notes | Bu, Apigee doküman ekibinin Jira'dan sürüm notları oluşturmak için kullandığı API proxy'sidir. | JSONToXML XSL |
releasenotes_api.xsl |
| kerberos-credential-mediation | Bu örnekte, Apigee Edge'de Kerberos kimlik bilgisi aracılığının nasıl yapılacağı gösterilmektedir. | JavaCallout | Java JAR dosyası |
| oauth-advanced | Yetkilendirme sunucusu olarak Apigee Edge'in kullanıldığı, yetkilendirme kodu yetkilendirme türü akışının eksiksiz ve çalışan bir örneği. |
GenerateAccessToken Diğerleri... |
örnek koda bakın |
| oauth-client-credentials | İstemci kimlik bilgisi yetkilendirme türü için yapılandırılmış, tam işlevsel bir OAuth 2.0 jeton uç noktasını gösterir. | GenerateAccessToken | yok |
| oauth-login-app | Kullanımdan kaldırıldı. Bunun yerine oauth-advanced örneğine bakmanızı öneririz. | ||
| oauth-validate-key-secret | Parola yetkilendirme türü akışında kullanıcı kimlik bilgilerini doğrulamak için bir kimlik sağlayıcıyı çağırmadan önce istemcinin anahtarını ve gizli anahtarını doğrulama tekniğini gösterir. | OAuthV2 AssignMessage ExtractVariables ServiceCallout RaiseFault |
yok |
| oauth-verify-accesstoken | OAuth 2.0 erişim jetonlarını doğrulamak ve kotayı doğrulamak için yapılandırılmış bir API proxy'sini gösterir. | VerifyAccessToken Quota |
yok |
| oauth10a-3legged | OAuth 1.0a üç aşamalı yapılandırmasını gösterir. | GenerateAccessToken GenerateRequestToken ServiceCallout VerifyAccessToken |
yok |
| outbound-oauth | Tweetleri çevirmek için Microsoft Azure Translator API'yi kullanır. Bunu yapmak için bir OAuth erişim jetonu almak üzere giden bir çağrı yapar ve ardından API Hizmetleri önbelleğe alma politikalarını kullanarak jetonu önbelleğe alır. Giden her çağrı yapıldığında önbelleğe alınan jetonu yeniden kullanır. Ayrıca, API proxy'sini çağırmak için kullanılan bir gösterim tarayıcı uygulaması da içerir. | AssignMessage LookupCache PopulateCache JavaScript |
api-config.js api-token-get.js translate-query.js translate-results.js |
| sayfalara ayırma | Bir XML yanıt mesajını, istemci tarafından sağlanan sınır ve ofset parametrelerine göre sayfalandırır. | AssignMessage ExtractVariables ResponseCache VerifyApiKey XSL |
paginate.xslt |
| response-cache | Hava durumu tahminlerinin Edge'de 10 dakika boyunca nasıl önbelleğe alınacağını gösterir. | ResponseCache AssignMessage |
yok |
| simple-python | Yanıtın içine başlık değeri ekleyen bir Python komut dosyası ekleme ile ilgili basit bir senaryoyu gösterir. |
Komut dosyası (Python) | setHeader.py |
| soap | ?wsdl sorgu parametresiyle yapılan bir isteğe yanıt olarak bir WSDL dosyasını yeniden yazan bir XSL dönüşümünü gösterir. | AssignMessage ExtractVariables Script (Python) XSL |
calculateaddress.py fixwsdl.xsl |
| yayın | HTTP akışı yapılandırmasını gösterir. | yok | yok |
| target-reroute | İstek mesajının içeriğine göre hedef URL'yi dinamik olarak seçmek için JavaScript'in nasıl kullanılacağını gösterir. | ExtractVariables Javascript |
rewriteTargetUrl.js |
| twitter-mobile-timeline | JavaScript'i kullanarak tweet'lerden gereksiz parametrelerin nasıl çıkarılacağını gösterir. Bu sayede, kaynakları sınırlı mobil cihazlar için uygun olan, kolaylaştırılmış bir Twitter zaman akışı elde edilir. | AssignMessage Javascript |
MobileTimeline.js |
| twitter-oembed | Zaman çizelgesi yanıtlarını (ör. statuses/user_timeline.json) zaman çizelgesi verilerini zengin HTML içeriği olarak içeren bir oEmbed yanıtına dönüştürür. | AssignMessage JavaScript |
search-oembed.js |
| değişkenler | Taşıma ve JSON ile XML mesaj içeriğine göre değişkenlerin nasıl ayıklanacağını ve ayarlanacağını gösterir. | AssignMessage ExtractVariables XMLToJSON |
minimize.js |
| xmltojson | Yanıt verilerini XML'den JSON'a dönüştürür. | XMLToJSON JSONToXML |
yok |
|
|
API proxy'lerini, politikaları, API ürünlerini, geliştirici ve uygulama profillerini yapılandırırken referans olarak kullanabileceğiniz XML şema dosyaları. |
||
|
|
Bir API proxy'sini Apigee Edge'deki bir kuruluşa aktaran ve ardından belirtilen ortama dağıtan bir dağıtım aracı (deploy.py) içerir. |
||
|
|
Kuruluş anlık görüntüsü aracı, geliştiriciler, API ürünleri, sanal ana makineler, anahtar/değer eşlemeleri vb. dahil olmak üzere kuruluş ayarlarını alır. Bir kuruluşun ayrıntılarını yedeklemek veya bir kuruluştaki ayarları keşfetmek için kullanılabilir. |
Apigee-127
Kod yazıyorsanız Apigee-127 ile Node.js ve Swagger kullanarak API proxy'leri oluşturup kod yazmaya başlayabilirsiniz. A127 örneklerini GitHub'da da bulabilirsiniz: https://github.com/apigee-127/a127-samples.
Deneyiminizi paylaşın
Deneyimlerinizi Apigee Geliştirici Forumu'nda paylaşın.