Ö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. Deneme hesabına http://accounts.apigee.com/accounts/sign_up adresinden kaydolabilirsiniz.

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

Araç	Açıklama
Git	Örnekler GitHub'da bulunur. Cihazınızda Git yüklü değilse lütfen GitHub'ın git kurulum talimatlarına bakın. Git'i yüklemek istemiyorsanız https://github.com/apigee/api-platform-samples adresinden dosyalara göz atabilir ve bir ZIP indirebilirsiniz.
Python	Apigee dağıtım aracını çalıştırmak için Python gereklidir. Python çoğu Linux ortamında, XCode yüklü bir Mac'te, Cygwin yüklü bir Windows makinesinde ve daha birçok yerde mevcuttur. Python'u edinmek için lütfen Python indirme sayfasına bakın.
curl	Örnek kurulum komut dosyaları da curl kullanır. curl ürününün yolunuzda yüklü ve kullanılabilir olduğundan emin olun (sisteminizde kullanılabilir olup olmadığını görmek için which curl komutunu çalıştırın).
dos2unix	Cygwin'i Windows'da çalıştırıyorsanız dos2unix yardımcı programına da ihtiyacınız olabilir. (Cygwin yükleyici, yardımcı programı yüklemenize izin verir.)

Örnekleri indir

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

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

Örnek API proxy'lerini içe aktarın ve dağıtın

Ö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) ayarlamak için bu dosyayı düzenleyin.
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 3-4 dakika sürer.) OAuth için kullanılan API ürünlerini, geliştiricilerini ve uygulamalarını dağıtmak için istemleri takip edin.

5. Dağıtma komut dosyası tamamlandıktan sonra sample-proxies dizinine gidin. sample-proxies dizininde her örnek proxy için bir dizin görürsünüz. Her dizinde, örneği çalıştırmayla ilgili bilgiler içeren bir README.md dosyası ve örneklerde küçük değişiklikler yapmanıza, dağıtım yapmanıza ve daha sonra, yaptığınız değişikliğin nasıl bir etkiye sahip olduğunu görmek için örneği çağırmanıza yardımcı olacak 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ğırın

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

/sample-proxies/proxy_name dizininde aşağıdaki komutu yürütün:

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:

• Sorun gidermeye giriş
• Windows/Cygwin Sorunlarını Giderme

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

Örnek proxy'ler tipik olarak değişiklik yapmak, dağıtmak ve çağırmak için kullanılır. Bu, küçük değişiklikler yapmanıza ve ardından bunların yanıt mesajı üzerindeki etkisini görmenize olanak tanır.

Ö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ı aşağıdaki konumda değiştirin:

/apiproxy/targets/target_name.xml

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

/apikey/apiproxy/targets/default.xml

Varsayılan yapılandırma, http://mocktarget.apigee.net değerine 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 mevcutsa 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 de aynı şekilde değiştirilebilir. Böylece, mevcut hedef hizmetlerinizde API proxy işlevi kullanılır. Bununla birlikte bazı durumlarda, API proxy davranışı belirli mesaj biçimlerine bağlı olduğundan proxy'ler için ek yapılandırma değişiklikleri gerekebilir.