Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Bu konuda, API proxy'lerinin bazı temel özellikleri ve daha fazla bilgiye yönelik bağlantılar listelenmektedir.
API'ler, bir uygulamanın diğerinin özelliklerini kullanması için 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 dizi adım şeklinde yapılandırarak API proxy'lerini uygularsınız. Kaynak yolları, HTTP fiili, gövde gereksinimleri vb. içeren bir URL'nin bulunduğu uç noktaları tanımlayarak API proxy'sini istemcilere sunarsınız.
API proxy'si olarak adlandırılsa da istemci kodu 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'si mantığının sırasını düzenlersiniz.
Herhangi bir uygulamada, veriler koşul mantığı tarafından yönlendirilen uygulama üzerinden akar. Apigee Edge'de işleme yolu akışlardan oluşur. Akış, bir API proxy'sinin işleme yolunu oluşturan bir aşamalar (veya"adımlar") dizisidir. Akışlar, Apigee Edge'in istemciden arka uç kaynağına ve ardından tekrar istemciye kadar belirli yerlerde mantık ve davranış uygulamanıza olanak tanıdığı yerlerdir.
Akışlar hakkında daha fazla bilgi için Akışlarla proxy'nin nasıl yürütüleceğini kontrol etme başlıklı makaleyi inceleyin.
Durum verilerine, API proxy'leri tarafından oluşturulan akış değişkenleri aracılığıyla 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 dille genişletirken de bunlara erişebilirsiniz.
Bu değişkenler Apigee Edge tarafından tutulur. Bazıları varsayılan olarak bulunur. Bunun nedeni genellikle API proxy'lerinin yaptığı işlemlerle ortak olmalarıdır (ör. HTTP isteğinin bir parçası olmaları). Ayrıca, bir mantık koşulunu 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 eden ve 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 başlıklı makaleyi inceleyin.
Politikaları kullanarak API proxy'sinde mantığın büyük bir kısmını 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 alanın mantığını 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 hedefleri için en iyi sırada yürütmesi amacıyla politikaları bir akış içindeki "adımlar" dizisi halinde düzenlersiniz.
Politikalar hakkında daha fazla bilgi için Politika nedir? başlıklı makaleyi inceleyin.
Yeniden kullanılabilir işlev kümeleri ekleyebilirsiniz.
API proxy'niz, kodunuzda birden fazla yerden (ör. diğer API proxy'leri) kullanılacak mantık 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 tekrarları 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'lerini birbirine bağlama hakkında daha fazla bilgi için API proxy'lerini birbirine bağlama başlıklı makaleyi inceleyin.
İzleme aracıyla 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 İzleme aracı içerir. Araç, bir istek için yürütülen her API proxy adımını görsel olarak sunar. 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'si hatalarını hata olarak ele alıyorsunuz
Hata işleyici yapılandırarak bir API istemcisine döndürülen hatayı özelleştirebilirsiniz. Hata işleyiciler, hatanın kendi kodunuzdan mı yoksa dahil edilen bir bileşenden (ör. politika) 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.