API'leri ve API proxy'lerini anlama

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

Apigee Edge, uygulama geliştiriciler tarafından kullanılabilen RESTful API'leri kolayca ve hızlı bir şekilde oluşturmanıza olanak tanır. Arka uç hizmetleri için yönetilen "katmanlar" görevi gören API proxy'leri oluşturarak Edge'de API'leri kullanıma sunarsınız. Bu konuda, Apigee Edge'deki API'ler ve API proxy'leri arasındaki ilişki ele alınmaktadır.

Video: API proxy'lerine giriş için bu kısa videoyu izleyin.

API nedir?

API, bir uygulamanın başka bir uygulamanın özelliklerini veya verilerini "tüketmesini" kolaylaştıran bir arayüzdür. API'ler, uygulama mantığına ve verilere yönelik kararlı ve basitleştirilmiş giriş noktaları tanımlayarak geliştiricilerin diğer geliştiriciler tarafından oluşturulan uygulama mantığına kolayca erişmesini ve bu mantığı yeniden kullanmasını sağlar. "Web API'leri" söz konusu olduğunda bu mantık ve veriler ağ üzerinden kullanıma sunulur.

API'leri kullanan uygulamalar değişikliklere karşı hassas olduğundan API'ler aynı zamanda bir "sözleşme" anlamına da gelir. Sözleşme, API'nin zaman içinde tahmin edilebilir bir şekilde değişeceğine dair bir güvence sağlar.

Apigee Edge, API'ler oluşturmanıza ve mevcut API'lerinizi doğrudan kullanıma sunmanıza olanak tanırken bir yönetim ve görünürlük katmanı ekler. SOA tabanlı web hizmetleri gibi HTTP'nin etkin olduğu hizmetleriniz varsa bunlar Apigee Edge üzerinden API olarak da kullanılabilir.

Edge, API Hizmetleri platformunda barındırılan uygulamaları uygulayarak arka uç hizmeti olmadan API'ler oluşturmanıza da olanak tanır. Bu uygulamaları JavaScript, Java ve Node.js'de oluşturabilirsiniz.

API proxy'si nedir?

Apigee Edge'de API proxy'leri uygulayarak API'leri kullanıma sunarsınız. API proxy'leri, uygulamaya yönelik API'yi arka uç hizmetlerinizden ayırarak bu uygulamaları arka uç kodu değişikliklerinden korur. Hizmetlerinizde arka uç değişiklikleri yaparken uygulamalar aynı API'yi kesintisiz olarak çağırmaya devam eder.

API proxy yapılandırmasında iki tür uç nokta vardır:

  • ProxyEndpoint: İstemci uygulamalarının API'lerinizi kullanma şeklini tanımlar. ProxyEndpoint'i yapılandırarak API proxy'nizin URL'sini tanımlarsınız. Proxy uç noktası, uygulamaların API proxy'sine HTTP veya HTTPS üzerinden erişip erişmeyeceğini de belirler. Güvenliği, kota kontrollerini ve diğer erişim denetimi ve hız sınırlama türlerini zorunlu kılmak için genellikle ProxyEndpoint'e politikalar eklersiniz.
  • TargetEndpoint: API proxy'sinin arka uç hizmetlerinizle etkileşim şeklini tanımlar. TargetEndpoint'i, güvenlik ayarları, HTTP veya HTTPS protokolü ve diğer bağlantı bilgileri de dahil olmak üzere istekleri uygun arka uç hizmetine yönlendirecek şekilde yapılandırırsınız. Yanıt iletilerinin ilk isteği gönderen uygulama için doğru şekilde biçimlendirildiğinden emin olmak üzere TargetEndpoint'e politikalar ekleyebilirsiniz.

API proxy'lerini aşağıdaki grafikte gösterildiği gibi görselleştirebilirsiniz:

HTTP istekleri, proxy isteği uç noktasından girer, hedef istek uç noktasına iletilir ve ardından arka uç hizmetlerine gönderilir. HTTP yanıtları hedef yanıt uç noktası üzerinden girer, proxy yanıt uç noktasına ve ardından istemciye geri iletilir.

API proxy'si nasıl oluşturulur?

API proxy'si, XML yapılandırma dosyaları ve kod (ör. JavaScript ve Java) paketinden oluşur. Apigee, API proxy'leri oluşturmak için çeşitli yöntemler sunar. Örneğin:

  • Grafik kullanıcı arayüzünde (GUI) API proxy'si tanımlamak için Edge yönetim kullanıcı arayüzünü kullanma. Daha fazla bilgi için Basit bir API proxy'si oluşturma başlıklı makaleyi inceleyin.
  • API proxy'nizi tanımlayan XML dosyaları ve diğer destekleyici dosyaları oluşturup Edge'e aktarma.
  • Edge'e bir dizi REST isteği göndererek Edge Management API'yi kullanarak API proxy'lerinizi oluşturma.
  • Node.js uygulamasını proxy olarak dağıtın. Bağımsız bir Node.js uygulamasını dağıtma başlıklı makaleyi inceleyin.

Politika nedir?

Edge, politikalar kullanarak kod yazmadan API davranışını kontrol etmenizi sağlar. Politika, proxy isteği/yanıt akışının bir parçası olarak belirli ve sınırlı bir yönetim işlevini uygulayan bir modüle benzer. Politikalar, API'ye yaygın yönetim özelliklerini kolay ve güvenilir bir şekilde eklemenizi sağlamak için tasarlanmıştır. Politikalar; güvenlik, sıklık sınırlama, dönüştürme ve aracılık gibi özellikler sunarak bu işlevselliği kendi başınıza kodlamanız ve sürdürmeniz gerekmesini önler.

İlk API proxy'nizi oluşturma

Apigee, ilk API'nizi oluşturmak için kullanabileceğiniz bir dizi eğitim sunar. İlk API proxy'nizi oluşturma başlıklı makaleyle başlayın.

API proxy'leri hakkında bilgi edinmenin harika bir yolu, Örnek API proxy'lerini kullanma bölümünde açıklandığı gibi örneklerle çalışmaktır.

Daha fazla bilgi