API'leri ve API proxy'lerini anlama

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

Apigee Edge, uygulama geliştiricileri tarafından kullanılabilecek RESTful API'leri kolayca ve hızlıca oluşturmanıza olanak tanır. Arka uç hizmetleri için yönetilen "yüz"ler gibi çalışan API proxy'leri oluşturarak API'leri Edge'de kullanıma sunarsınız. Bu konuda, Apigee Edge'deki API'ler ile 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 "kullanmasına" olanak tanıyan bir arayüzdür. API'ler, uygulama mantığına ve verilere kararlı, basitleştirilmiş giriş noktaları tanımlayarak geliştiricilerin diğer geliştiriciler tarafından oluşturulan uygulama mantığına kolayca erişip bu mantığı yeniden kullanmasını sağlar. "Web API'leri" söz konusu olduğunda bu mantık ve veriler ağ üzerinden paylaşılır.

API'leri kullanan uygulamalar değişikliklere karşı hassas olduğundan API'ler bir "sözleşme"yi de ifade eder. Sözleşme, API'nin zaman içinde tahmin edilebilir bir şekilde değişeceği konusunda belirli bir düzeyde güvence sağlar.

Apigee Edge, API oluşturmanıza ve halihazırda API'leriniz varsa bunları doğrudan kullanıma sunmanıza olanak tanır. Ayrıca bir yönetim ve görünürlük katmanı da ekler. SOA tabanlı web hizmetleri gibi HTTP etkin hizmetleriniz varsa bunlar Apigee Edge üzerinden API olarak da kullanıma sunulabilir.

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

API proxy'si nedir?

API proxy'leri uygulayarak API'leri Apigee Edge'de kullanıma sunarsınız. API proxy'leri, uygulamaya yönelik API'yi arka uç hizmetlerinizden ayırarak bu uygulamaları arka uç kod değişikliklerinden korur. Hizmetlerinizde arka uç değişiklikleri yaparken uygulamalar herhangi bir kesinti olmadan aynı API'yi ç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. API proxy'nizin URL'sini tanımlamak için ProxyEndpoint'i yapılandırırsınız. Proxy uç noktası, uygulamaların API proxy'sine HTTP mi yoksa HTTPS üzerinden mi erişeceğini de belirler. Genellikle güvenlik, kota kontrolleri ve diğer erişim denetimi ve hız sınırlama türlerini zorunlu kılmak için ProxyEndpoint'e policies eklersiniz.
  • TargetEndpoint: API proxy'sinin arka uç hizmetlerinizle etkileşim şeklini tanımlar. TargetEndpoint'i, istekleri uygun arka uç hizmetine yönlendirecek şekilde yapılandırırsınız. Bu işlemde güvenlik ayarları, HTTP veya HTTPS protokolü ve diğer bağlantı bilgileri tanımlanır. Yanıt mesajlarının ilk isteği yapan uygulama için doğru biçimlendirildiğinden emin olmak amacıyla TargetEndpoint'e policies ekleyebilirsiniz.

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

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

API proxy'si nasıl oluşturulur?

API proxy, XML yapılandırma dosyaları ve kod (ör. JavaScript ve Java) paketinden oluşur. Apigee, API proxy'leri oluşturmanız için aşağıdakiler de dahil olmak üzere çeşitli yöntemler sunar:

  • 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 ve ardından Edge'e aktarılan diğer destekleyici dosyalarla birlikte XML dosyaları oluşturma.
  • Edge'e bir dizi REST isteği göndererek API proxy'lerinizi oluşturmak için Edge yönetim API'sini kullanma
  • Node.js uygulamasını proxy olarak dağıtın. Bağımsız Node.js uygulamasını dağıtma başlıklı makaleyi inceleyin.

Politika nedir?

Edge, policies kullanarak API davranışını kod yazmadan kontrol etmenize olanak tanır. Politika, proxy istek/yanıt akışı kapsamında belirli ve sınırlı bir yönetim işlevi uygulayan bir modül gibidir. Politikalar, API'lere yaygın yönetim özelliklerini kolayca ve güvenilir bir şekilde eklemenizi sağlamak için tasarlanmıştır. Politikalar güvenlik, ücret sınırlama, dönüşüm ve uyumlulaştırma gibi özellikler sunarak bu işlevleri kendiniz kodlamaktan ve yönetmekten kurtarır.

İ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şturun başlıklı makaleyi inceleyerek başlayın.

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

Daha fazla bilgi