Örnek API proxy'lerini kullanma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Ön koşullar

http://enterprise.apigee.com adresinde bir hesabınızın olması gerekir. http://accounts.apigee.com/accounts/sign_up adresinden deneme hesabına kaydolabilirsiniz.

Örnekleri kullanmak için aşağıdakilere de sahip olmanız gerekir:

Araç Açıklama
Git Örnekler GitHub'da yer alır. Git yüklü değilse lütfen GitHub'ın Git kurulum talimatlarına bakın. Git'i yüklemek istemiyorsanız dosyalara göz atabilir ve https://github.com/apigee/api-platform-samples adresinden bir ZIP dosyası indirebilirsiniz.
Python

Apigee dağıtım aracını çalıştırmak için Python gereklidir. Python; çoğu Linux ortamında, XCode'un yüklü olduğu bir Mac'te, Cygwin'in yüklü olduğu bir Windows makinesinde ve daha birçok yerde bulunur.

Python'u edinmek için lütfen Python indirme sayfasına bakın.
curl Örnek kurulum komut dosyalarında da curl kullanılır. curl'nın yüklendiğinden ve yolunuzda kullanılabilir olduğundan emin olun (sisteminizde kullanılabilir olup olmadığını görmek için which curl komutunu çalıştırın).
dos2unix Windows'da Cygwin kullanıyorsanız dos2unix yardımcı programına da ihtiyacınız olabilir. (Cygwin yükleyici, yardımcı programı yüklemenize olanak tanır.)

Örnekleri indirme

Örnek dosyaları almak için aşağıdaki örnekte gösterildiği gibi git clone kullanın:

git clone https://github.com/apigee/api-platform-samples.git

Örnek API proxy'lerini içe aktarma ve dağıtma

Örnekleri komut satırından içe aktarın ve dağıtın:

  1. Örnekleri indirdikten sonra aşağıdaki örnekte gösterildiği gibi /setup dizinine gidin: 
    cd setup
  2. /setup dizininde setenv.sh dosyasını bulun.
  3. Bu dosyayı düzenleyerek kuruluşunuzu, kullanıcı adınızla ilişkili e-posta adresini ve API proxy'lerini dağıtmak istediğiniz ortamı (üretim veya test) ayarlayın.
  4. setenv.sh dosyasını düzenledikten sonra aşağıdakileri yürütün: 
    sh deploy_all.sh

    Bu komut dosyası, tüm API proxy örneklerini kuruluşunuza dağıtır. (Bu işlem 3-4 dakika sürer.) API ürünlerini, geliştiricileri ve uygulamaları (OAuth için kullanılır) dağıtmak üzere istemleri uygulayın.

  5. Dağıtım komut dosyası tamamlandıktan sonra sample-proxies dizinine gidin. Dizinde sample-proxies her örnek proxy için bir dizin bulunur. Her dizinde, örneği çalıştırma hakkında bilgi içeren bir README.md dosyası ve örneklerde küçük değişiklikler yapmanıza, dağıtmanıza ve ardından değişikliğinizin etkisini görmek için örneği çağırmanıza yardımcı olan iki komut dosyası bulunur:
    • invoke.sh: API proxy'sinin dağıtılan sürümünü çağırmak için bu komut dosyasını yürütün.
    • deploy.sh: Herhangi bir değişiklik yaptıktan sonra API proxy'sini dağıtmak için bu komut dosyasını çalıştırın.

Örnek API proxy'lerini çağırma

Her örnek proxy'nin, dağıttıktan sonra API proxy'sini çağırmak için kullanılabilecek ilişkili bir kabuk komut dosyası vardır.

/sample-proxies/proxy_name dizininden aşağıdakileri yürütün:

sh invoke.sh

Bu işlem, kuruluşunuzdaki test ortamında çalışan proxy'yi çağırır.

Sorun giderme

Sorun giderme bilgileri için aşağıdakilere bakın:

Örnek API proxy'lerini değiştirme ve yeniden kullanma

Örnek proxy'lerin tipik kullanımı değiştirme, dağıtma ve çağırmadır. Bu sayede küçük değişiklikler yapabilir ve bunların yanıt mesajı üzerindeki etkisini görebilirsiniz.

Bir örnek API proxy'sini farklı bir arka uç hizmetine yönlendirecek şekilde değiştirmek için aşağıdaki konumdaki XML yapılandırma dosyasını değiştirin:

/apiproxy/targets/target_name.xml

Örneğin, API anahtarı örneğini kendi arka uç hizmetinize yönlendirmek için şu dosyayı bulun:

/apikey/apiproxy/targets/default.xml

Varsayılan yapılandırma http://mocktarget.apigee.net'yı işaret ediyorsa (örneğin):

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

ve arka uç hizmetiniz http://api.myproject.com/ adresinde kullanılabiliyorsa yapılandırmayı aşağıdaki gibi değiştirirsiniz:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

Değişikliklerinizi kaydettikten sonra API proxy'sini aşağıdaki örnekte gösterildiği gibi dağıtın:

sh deploy.sh

Diğer API proxy'leri, API proxy işlevini mevcut hedef hizmetlerinizde kullanmak için aynı şekilde değiştirilebilir. Ancak bazı durumlarda API proxy'si davranışı belirli mesaj biçimlerine bağlıdır. Bu nedenle, proxy'lerin ek yapılandırma değişikliklerine ihtiyacı olabilir.