API Proxy'si geliştirme sürecinin önemli noktaları

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

Bu konuda, API proxy'lerinin bazı temel özellikleri ve daha fazla bilginin bulunduğu bağlantılar listelenmiştir.

API'ler, bir uygulamanın başka bir uygulamanın özelliklerini kullanabileceği giriş noktalarıdır. API oluşturmak için API proxy'leri uygularsınız

Apigee Edge'de, API proxy mantığını istemci kodundan gelen bir isteğe yanıt olarak yürütülen bir adım dizisi olarak yapılandırarak API proxy'lerini uygularsınız. Kaynak yolları, HTTP fiili, gövde koşulları vb. içeren bir URL içeren uç noktalar tanımlayarak istemcilere bir API proxy'si sunarsınız.

API proxy olarak adlandırılsa da istemci kodunun bakış açısından API'dir.

API proxy'lerine genel bakış için API'leri ve API proxy'lerini anlama başlıklı makaleyi inceleyin.

Akışları kullanarak API proxy mantığı sırasını düzenlersiniz

Her uygulamada veriler, koşul mantığına göre uygulama üzerinden akar. Apigee Edge'de işleme yolu akışlardan oluşur. Akış, API proxy'sinin işleme yolunu oluşturan bir dizi aşamadır (veya"adım"dır). Apigee Edge, akışlar aracılığıyla istemciden arka uç kaynağına ve ardından istemciye belirli yerlerde mantık ve davranış uygulamanıza olanak tanır.

Akışlar hakkında daha fazla bilgi için Bir proxy'nin akışlarla nasıl çalıştığını kontrol etme başlıklı makaleyi inceleyin.

API proxy'leri tarafından oluşturulan akış değişkenleri aracılığıyla durum verilerine erişirsiniz.

API proxy'si, yürütme durumunu temsil eden değişkenlere erişebilir. Bu değişkenlere, API proxy'lerinizi ve politikalarınızı yapılandıran XML'den erişebilirsiniz. Ayrıca, bir API proxy'sini Java, JavaScript veya Python gibi prosedürel bir dil ile genişletirken de bu işlevlere erişebilirsiniz.

Bu değişkenler Apigee Edge tarafından tutulur. Bazıları varsayılan olarak mevcuttur. Bunun nedeni genellikle API proxy'lerinin yaptığı işlemlerle ortak olmalarıdır (ör. bir HTTP isteğinin parçası olmaları). Mantık şartını karşılamak için kendi değişkenlerinizi de oluşturabilirsiniz.

Değişkenler hakkında daha fazla bilgi için Akış değişkenleriyle proxy durumunu yönetme başlıklı makaleyi inceleyin.

API proxy'lerinin koşullu olarak yürütülmesini sağlayabilirsiniz

Çoğu programlama dilinde olduğu gibi, API proxy'lerinde de kodun koşullu olarak yürütülmesini sağlayabilirsiniz. Koşullar genellikle akış değişkenleri aracılığıyla erişebileceğiniz API proxy durumuna dayanır. Örneğin, kullanıcı aracısını kontrol edip isteği buna göre işleyen bir koşulunuz olabilir.

Koşullu yürütme hakkında daha fazla bilgi için Akış değişkenleri ve koşulları bölümüne bakın.

API proxy'sinde mantığın çoğunu politikaları kullanarak uygularsınız

API proxy'sine eklediğiniz mantığın çoğu politika olarak paketlenir. Politika, güvenlik veya trafik yönetimi gibi işlevsel bir alanla ilgili mantığı kapsayan bir Apigee Edge bileşenidir. Temel mantığın özelliklerini ayarlayan XML ile bir politika yapılandırırsınız. API proxy'nizin mantığı proxy'nizin hedeflerine en uygun sırada yürütmesi için politikaları bir akış içinde "adım" dizisi olarak düzenlersiniz.

Politikalar hakkında daha fazla bilgi için Politika nedir? başlıklı makaleyi inceleyin.

Yeniden kullanılabilir işlev grupları ekleyebilirsiniz

API proxy'niz, kodunuzdaki birden fazla yerden kullanılacak mantık (ör. diğer API proxy'leri) içeriyorsa bu mantığı birden fazla yerden gelen çağrılar için toplayabilirsiniz. Örneğin, diğer API proxy'lerinin çağırdığı paylaşılan bir akışta güvenlik mantığını gruplandırarak API proxy'leri arasındaki kopyaları azaltabilirsiniz.

Paylaşılan akışlar hakkında daha fazla bilgi için Yeniden kullanılabilir paylaşılan akışlar başlıklı makaleyi inceleyin. API proxy'si zincirleme hakkında daha fazla bilgi için API proxy'lerini birbirine bağlama başlıklı makaleyi inceleyin.

İzleme aracıyla bir proxy'de hata ayıklama yapabilirsiniz

Apigee Edge, hata ayıklama ve test sırasında API proxy'nizin yürütme akışını incelemek için kullanabileceğiniz bir izleme aracı içerir. Araç, bir istek için yürütülen her API proxy adımını görsel olarak sunar. Bir hata ayıklayıcıda olduğu gibi, her adımda API proxy durumunu oluşturan değişken değerlerinin listesini görüntüleyebilirsiniz.

İzleme ile hata ayıklama hakkında daha fazla bilgi için İzleme aracını kullanma başlıklı makaleyi inceleyin.

API proxy hatalarını hata olarak ele alırsınız

Bir hata işleyici yapılandırarak API istemciye döndürülen hatayı özelleştirebilirsiniz. Hata işleyiciler, hatanın kendi kodunuzdan mı yoksa dahil edilen bir bileşenden (politika gibi) mi kaynaklandığına bakılmaksızın hata mesajları üzerinde kontrol sahibi olmanızı sağlar.

Daha fazla bilgi için Hataları ele alma başlıklı makaleyi inceleyin.