API'leri ve API proxy'lerini anlama

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

Apigee Edge sayesinde uygulama geliştiricilerin kullanabileceği RESTful API'leri kolay ve hızlı bir şekilde derleyebilirsiniz. Edge'de API'leri, arka uç hizmetleri için yönetilen "cepheler" görevi gören API proxy'leri oluşturarak ortaya çıkarırsınız. Bu konuda, Apigee Edge'de API'ler ve API proxy'leri arasındaki ilişki ele alınmaktadır.

Video: API proxy'lerine giriş için bu kısa videoya göz atın.

API nedir?

API, bir uygulamanın başka bir uygulamanın özelliklerini veya verilerini "tüketmesini" kolaylaştıran 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şmelerini ve bunları tekrar kullanmalarını sağlar. "Web API'leri" söz konusu olduğunda, bu mantık ve veriler ağ üzerinden açığa çıkarılır.

API 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 miktar güvence sağlar.

Apigee Edge sayesinde API'ler oluşturabilirsiniz. Zaten API'leriniz varsa bunları doğrudan kullanıma sunarken bir yönetim ve görünürlük katmanı da ekleyebilirsiniz. SOA tabanlı Web hizmetleri gibi HTTP özellikli hizmetleriniz varsa bunlar da Apigee Edge aracılığıyla API olarak sunulabilir.

Edge, arka uç hizmeti olmaksızın API Hizmetleri platformunda barındırılan uygulamaları uygulayarak API derlemenizi de sağlar. Bu uygulamaları JavaScript, Java ve Node.js'de derleyebilirsiniz.

API proxy'si nedir?

API proxy'leri uygulayarak API'leri Apigee Edge'de kullanıma sunabilirsiniz. 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 yaptıkça uygulamalar kesintisiz bir şekilde aynı API'yi çağırmaya devam eder.

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

  • ProxyEndpoint: İstemci uygulamalarının API'lerinizi nasıl kullanacağını tanımlar. ProxyEndpoint'i, API proxy'nizin URL'sini tanımlayacak şekilde yapılandırırsınız. Proxy uç noktası, uygulamaların API proxy'sine HTTP veya HTTPS üzerinden erişip erişemeyeceğini de belirler. Genellikle güvenliği, kota kontrollerini ve diğer erişim denetimi ve hız sınırlandırması türlerini uygulamak için ProxyEndpoint'e genellikle politikalar eklersiniz.
  • TargetEndpoint: API proxy'sinin arka uç hizmetlerinizle etkileşim kurma şeklini tanımlar. TargetEndpoint'i, istekleri uygun arka uç hizmetine yönlendirecek şekilde yapılandırırsınız. Güvenlik ayarlarını, HTTP veya HTTPS protokolünü ve diğer bağlantı bilgilerini tanımlamak da buna dahildir. Yanıt mesajlarının, ilk isteği yapan uygulamaya uygun şekilde biçimlendirildiğinden emin olmak için TargetEndpoint'e politikalar ekleyebilirsiniz.

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

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

API proxy'si nasıl oluşturulur?

API proxy'si, bir XML yapılandırma dosyası ve kod paketinden (JavaScript ve Java gibi) oluşur. Apigee, aşağıdakiler de dahil olmak üzere API proxy'leri oluşturmanız için ç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 konusuna bakın.
  • API proxy'nizi tanımlayan diğer destekleyici dosyalarla birlikte XML dosyaları oluşturma ve bunları Edge'e aktarma.
  • Edge'e bir dizi REST isteği göndererek API proxy'lerinizi oluşturmak için Edge Management API'yi kullanma.
  • Bir Node.js uygulamasını proxy olarak dağıtın. Bağımsız bir Node.js uygulamasını dağıtma bölümünü inceleyin.

Politika nedir?

Edge, politikaları kullanarak herhangi bir kod yazmadan API davranışını kontrol edebilmenizi sağlar. Politika, proxy istek/yanıt akışının bir parçası olarak belirli, sınırlı bir yönetim işlevini uygulayan modüllere benzer. Politikalar, bir API'ye kolay ve güvenilir bir şekilde yaygın yönetim özelliği türlerini eklemenizi sağlayacak şekilde tasarlanmıştır. Politikalar; güvenlik, hız sınırlama, dönüştürme ve uyumlulaştırma özellikleri gibi özellikler sunarak sizi bu işlevleri tek başınıza kodlayıp yönetme zorunluluğundan kurtarır.

İlk API proxy'nizi oluşturun

Apigee, ilk API'nizi oluşturmak için kullanabileceğiniz bir dizi eğitici sunar. İlk API proxy'nizi oluşturma başlıklı makaleyle 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