Örnek API proxy'lerini kullanma

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

Ön koşullar

http://enterprise.apigee.com adresinde bir hesabınız olmalıdır. Kaydolabilirsiniz şundaki deneme hesabı için: http://accounts.apigee.com/accounts/sign_up.

ekleyin.

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

Araç Açıklama
Git Örnekler GitHub'da bulunmaktadı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 gerekir. Python, çoğu Linux'ta mevcuttur ortamına entegre etmek için XCode yüklü bir Mac'te, Cygwin yüklü bir Windows makinesinde ve daha pek çok yerde bulunabilir.

Python'u edinmek için lütfen Python indirme sayfası.

curl Örnek kurulum komut dosyaları da curl etiketini kullanır. curl uygulamasının yüklü olduğundan ve (yolunuzda kullanılabilir durumda olup olmadığını görmek için which curl komutunu sisteminizde bulabilirsiniz).
dos2unix Cygwin'i Windows'da çalıştırıyorsanız dos2unix yardımcı olur. (Cygwin yükleyici yardımcı programı yüklemenize izin verir.)

Örnekleri indir

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

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

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

Ö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. Kuruluşunuzu, kullanıcı adınızla ilişkili e-posta adresini, ve API proxy'lerini dağıtmak istediğiniz ortam (üretim veya test).
  4. setenv.sh öğesini düzenledikten sonra aşağıdakini yürütün:
    sh deploy_all.sh

    Bu komut dosyası, tüm API proxy örneklerini kuruluşunuza dağıtır. (İşlem yaklaşık 3-4 dakika sürer minutes.) Şu amaçlar için kullanılır: API ürünlerini, geliştiricilerini ve uygulamalarını dağıtmak OAuth) ekleyin.

  5. Dağıtma komut dosyası tamamlandıktan sonra sample-proxies dizinine gidin. sample-proxies dizininde örnek proxy başına bir dizin bulunur. Her birinde dizini, örneği çalıştırmayla ilgili bilgileri içeren bir README.md dosyası ve örnekler üzerinde küçük değişiklikler yaparken, bunları dağıttığınızda ve değişikliğinin nasıl bir etkisi oldu:
    • invoke.sh: API'nin dağıtılan sürümünü çağırmak için bu komut dosyasını yürütün. temsil eder.
    • deploy.sh: Herhangi bir değişiklik yaptıktan sonra API proxy'sini dağıtmak için anlamına gelir.

Örnek API proxy'lerini çağırma

Her örnek proxy'nin, API proxy'sini çağırmak için kullanılabilecek ilişkili bir kabuk komut dosyası vardır ne kadar iyi karşıladığını görebileceksiniz.

/sample-proxies/proxy_name dizininden takip etmek için:

sh invoke.sh

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

Sorun giderme

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

Örnek API proxy'lerini değiştirip yeniden kullanın

Örnek proxy'ler genellikle değiştirme, dağıtma ve çağırma amacıyla kullanılır. Bu sayede yapabilecekleriniz, ve bunların yanıt mesajı üzerinde ne gibi etkileri olduğunu görmeye çalışın.

Örnek bir API proxy'sini farklı bir arka uç hizmetini işaret edecek şekilde değiştirmek için XML yapılandırma dosyasını şu konumda bulabilirsiniz:

/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 değerini gösteriyorsa, ö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>

arka uç hizmetiniz http://api.myproject.com/ adresinde mevcutsa yapılandırmayı aşağıdaki gibi görünecek şekilde değiştirin:

<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 kullanmak için aynı şekilde değiştirilebilir karşılaştırabilirsiniz. Bununla birlikte bazı durumlarda API proxy'sinin davranışı Bu nedenle proxy'ler için ek yapılandırma değişiklikleri gerekebilir.