Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Apigee Edge, API geliştirme ve yönetme platformudur. Edge, hizmetleri bir proxy katmanıyla ön plana çıkararak arka uç hizmeti API'leriniz için bir soyutlama veya hafif bileşen sağlar ve güvenlik, sıklık sınırlaması, kotalar, analizler gibi özellikler sunar.
Dijital hızlanma
Bu videoda, Apigee'nin dijital bir işletmeye dönüşmenize nasıl yardımcı olduğuna dair kısa bilgiler verilmektedir.
Hizmet yönetimi ve API yönetimi arasında seçim yapma
Bu video, hizmet yönetimi ile API yönetimi arasındaki önemli farkları anlamanıza yardımcı olur. olduğunuzu varsayalım.
Hizmetlerinizi web'de kullanıma sunma
Günümüzde şirketler, arka uç hizmetlerini web'de kullanılabilir hâle getirmek istiyor. Böylece bu hizmetler, mobil cihazlarda ve masaüstü bilgisayarlarda çalışan uygulamalar tarafından kullanılabiliyor. Bir şirket, ürün fiyatlandırması ve stok durumu bilgileri, satış ve sipariş hizmetleri, sipariş takibi hizmetleri ve istemci uygulamaları için gerekli olan diğer hizmetleri kullanıma sunmak isteyebilir.
Şirketler genellikle hizmetleri bir dizi HTTP uç noktası olarak kullanıma sunar. İstemci uygulaması geliştiricileri daha sonra bu uç noktalara HTTP istekleri gönderir. Hizmet, uç noktaya bağlı olarak XML veya JSON olarak biçimlendirilmiş verileri istemci uygulamasına geri döndürebilir.
Bu hizmetleri kullanan istemci uygulamaları, mobil cihaz veya tablet için bağımsız uygulamalar, tarayıcıda çalışan HTML5 uygulamaları ya da bir HTTP uç noktasına istekte bulunup yanıt verilerini kullanabilen diğer uygulama türleri olarak uygulanabilir. Bu uygulamalar, hizmetleri kullanıma sunan şirket tarafından veya herkese açık hizmetlerden yararlanan üçüncü taraf uygulama geliştiriciler tarafından geliştirilip yayınlanabilir.
Aşağıdaki resimde bu tür bir model gösterilmektedir:
Sağlayıcılar hizmetlerini web üzerinden kullanıma sundukları için hizmetlerini güvenli hale getirmek ve yetkisiz erişime karşı korumak için gerekli tüm adımları attıklarından emin olmalıdır. Bir servis sağlayıcı olarak şunları göz önünde bulundurun:
- Güvenlik: Yetkisiz erişimi önlemek için hizmetlerinize erişimi nasıl kontrol edeceksiniz?
- Uyumluluk: Hizmetleriniz farklı platformlarda ve cihazlarda çalışacak mı?
- Ölçülebilirlik: Hizmetlerinizin kullanılabilir olduğundan emin olmak için bunları nasıl izleyebilirsiniz?
- Para kazanma: Müşterilerin hizmetlerinize erişimini nasıl takip edip faturalandırabilirsiniz?
- Ve diğer birçok husus
Herhangi bir hizmete erişen bir istemci uygulaması yayınlandıktan sonra servis sağlayıcı, bu hizmetleri eklerken, değiştirirken veya silerken bu hizmetlerin zaman içinde çalışmaya devam etmesini sağlamakla yükümlüdür. Ayrıca, servis sağlayıcı, istemci uygulamalarının bu hizmetlerle senkronize kalmasını sağlamak için uygulama geliştiricileri hizmetlerdeki değişikliklerden haberdar etmenin bir yolunu bulmalıdır.
İstemci uygulaması geliştiricileri, farklı sağlayıcıların hizmetlerini kullanmaya çalışırken zorluklarla karşılaşır. Günümüzde bir servis sağlayıcının hizmetlerini kullanıma sunmak için kullanabileceği birçok teknoloji vardır. Aynı istemci uygulaması, bir sağlayıcının hizmetini kullanmak için bir mekanizma, farklı bir sağlayıcının hizmetini kullanmak için ise farklı bir mekanizma kullanmak zorunda kalabilir. Uygulama geliştiriciler, aynı sağlayıcının hizmetlerini kullanmak için farklı mekanizmalar kullanmak zorunda kalabilir.
Hizmetleri Apigee Edge üzerinden kullanıma sunma
Apigee Edge, hizmet uygulamasından bağımsız olarak tüm hizmetlerinizde tutarlı olan iyi tanımlanmış bir API ile hizmetlerinize güvenli erişim sağlamanıza olanak tanır. Tutarlı bir API:
- Uygulama geliştiricilerin hizmetlerinizi kullanmasını kolaylaştırır.
- Herkese açık API'yi etkilemeden arka uç hizmet uygulamasını değiştirmenizi sağlar.
- Edge'e yerleştirilmiş analiz, para kazanma, geliştirici portalı ve diğer özelliklerden yararlanmanızı sağlar.
Aşağıdaki resimde, Edge'in istemci uygulamalarından gelen istekleri arka uç hizmetlerinize ilettiği bir mimari gösterilmektedir:
Uygulama geliştiriciler, hizmetlerinizi doğrudan kullanmak yerine Edge'de oluşturulan bir API proxy'sine erişir. API proxy'si, herkese açık bir HTTP uç noktasının arka uç hizmetinizle eşlemesi olarak işlev görür. API proxy'si oluşturarak Edge'in, hizmetlerinizi korumak için gereken güvenlik ve yetkilendirme görevlerini yönetmesine, ayrıca bu hizmetleri analiz etmesine, izlemesine ve para kazanma amacıyla kullanmasına izin verirsiniz.
Uygulama geliştiriciler, doğrudan hizmetlerinize değil bir API proxy'sine HTTP istekleri gönderdiğinden hizmetlerinizin uygulanması hakkında herhangi bir bilgiye ihtiyaç duymazlar. Geliştiricinin bilmesi gerekenler:
- API proxy uç noktasının URL'si.
- İstekle iletilen tüm sorgu parametreleri, üstbilgiler veya gövde parametreleri.
- Gerekli kimlik doğrulama ve yetkilendirme kimlik bilgileri.
- Yanıt veri biçimi (ör. XML veya JSON) dahil olmak üzere yanıtın biçimi.
API proxy'si, uygulama geliştiriciyi arka uç hizmetinizden ayırır. Bu nedenle, genel API tutarlı kaldığı sürece hizmet uygulamasını değiştirebilirsiniz. Tutarlı bir ön uç API'si sayesinde, mevcut istemci uygulamaları arka uçtaki değişikliklerden bağımsız olarak çalışmaya devam eder.
Arka uç hizmetinde herhangi bir değişiklik yapmanıza gerek kalmadan bir hizmete işlevsellik eklemek için API proxy'sinde politikalar kullanabilirsiniz. Örneğin, veri dönüşümleri ve filtreleme gerçekleştirmek, güvenlik eklemek, koşullu mantık veya özel kod yürütmek ve diğer birçok işlemi gerçekleştirmek için proxy'nize politikalar ekleyebilirsiniz. Unutulmaması gereken nokta, politikaları arka uç sunucunuzda değil, Edge'de uyguladığınızdır.
Daha fazla bilgi için API'leri ve API proxy'lerini anlama başlıklı makaleyi inceleyin.
API ürünü oluşturma
API proxy'si, geliştiricilerin arka uç hizmetlerinize erişmek için kullandığı Apigee Edge'deki HTTP uç noktasıdır. Mümkün olsa da genellikle tek tek API proxy'leri kullanıma sunmazsınız. Bunun yerine, bir veya daha fazla API proxy'sini bir API ürününde gruplandırırsınız.
API ürünü, hizmet planıyla birlikte API proxy'lerinden oluşan bir pakettir. Bu hizmet planı, API proxy'lerinde erişim sınırları belirleyebilir, güvenlik sağlayabilir, izleme ve analizlere izin verebilir ve ek özellikler sunabilir. API ürünleri, Edge'in API'leriniz için yetkilendirme ve erişim denetimi amacıyla kullandığı merkezi mekanizmadır.
API ürünleri oluştururken büyük bir esnekliğe sahip olursunuz. Örneğin, birden fazla API ürünü aynı API proxy'sini paylaşabilir. Aşağıdaki şekilde üç API ürünü gösterilmektedir. Tüm ürünlerin API proxy'si 3'e erişime izin verdiğini, ancak yalnızca A ürününün API proxy'si 1'e erişime izin verdiğini unutmayın.
Her API ürününde farklı özellikler ayarlayabilirsiniz. Örneğin, düşük erişim sınırına (günde 1.000 istek gibi) sahip bir API ürününü uygun fiyata sunabilirsiniz. Ardından, aynı API proxy'sine erişim sağlayan ancak çok daha yüksek bir erişim sınırına sahip başka bir API ürünü yayınlıyorsunuz. Bu ürünün fiyatı da daha yüksek oluyor. Alternatif olarak, hizmetlerinize salt okuma erişimi sağlayan ücretsiz bir API ürünü oluşturabilir ve ardından aynı API proxy'lerine okuma/yazma erişimi sağlayan bir API ürünü satabilirsiniz.
Daha fazla bilgi için API ürünlerini yönetme başlıklı makaleyi inceleyin.
İstemci tarafı bir uygulamanın API ürününüze erişmesine izin verme
Uygulama geliştiriciler hizmetlerinize erişmek istediklerine karar verdiklerinde öncelikle istemci uygulamalarını API ürününüze kaydetmelidir.
Kaydın ardından bir uygulama geliştirici, API ürününde yer alan bir API proxy'sine yapılan her isteğe eklemesi gereken bir API anahtarı alır. Bu anahtarın kimliği doğrulanır ve kimlik doğrulama başarılı olursa isteğin arka uç hizmetinize erişmesine izin verilir.
İstediğiniz zaman anahtarı iptal ederek istemci uygulamasının hizmetlerinize erişmesini engelleyebilirsiniz. Alternatif olarak, anahtarda zaman sınırı tanımlayabilirsiniz. Bu durumda, geliştiricinin belirli bir süre sonra anahtarı yenilemesi gerekir.
Geliştiricilerin API ürünlerinize erişmek için gönderdiği kayıt isteklerinin nasıl işleneceğine siz karar verirsiniz. Apigee Edge Developer Services'i kullanarak kayıt sürecini otomatikleştirebilir veya erişimi kontrol etmek için manuel bir süreç kullanabilirsiniz.
API ürünleri oluşturma ve bunları geliştiricilerin kullanımına sunma
- Herkese açık URL'leri arka uç hizmetlerinize eşleyen bir veya daha fazla API proxy'si oluşturun.
- API proxy'lerinizi paketleyen bir API ürünü oluşturun.
- API proxy'lerinizi ve API ürününüzü dağıtın.
- Geliştiricilerinize API ürününün kullanıma sunulduğunu bildirin.
Uygulama geliştiriciler API ürününüzün kullanıma sunulduğunu öğrendikten sonra:
- İstemci uygulamalarını API ürününüze kaydettirmelidir.
- API ürünü için bir API anahtarı alma.
- API proxy'leri (API ürününde paketlenmiş) aracılığıyla hizmetlerinize istekte bulunun ve her istekle birlikte API anahtarını iletin.
Apigee Edge'in bileşenleri
Apigee Edge; API çalışma zamanı, izleme ve analiz ile geliştirici hizmetlerinden oluşur. Bu hizmetler birlikte API oluşturma, güvenlik, yönetim ve operasyonlar için kapsamlı bir altyapı sağlar.
Aşağıdaki şekilde Edge hizmetleri gösterilmektedir:
Edge API çalışma zamanı
Apigee Edge API Hizmetleri, ister hizmet sağlayıcı olarak API proxy'leri oluşturuyor ister uygulama geliştirici olarak API'leri, SDK'ları ve diğer kolaylık hizmetlerini kullanıyor olun, API oluşturma ve kullanma ile ilgilidir.
API yönetim sunucusu, API proxy'lerinizi ekleme ve yapılandırma, API ürünleri oluşturma, uygulama geliştiricileri ve istemci uygulamalarını yönetme gibi işlemler için araçlar sağlar. Birçok yaygın yönetim sorununu arka uç hizmetlerinizden uzaklaştırır. API proxy'si eklediğinizde güvenlik, sıklık sınırlama, aracılık, önbelleğe alma vb. eklemek için API proxy'sine politikalar uygulayabilirsiniz. Ayrıca özel komut dosyaları uygulayarak, üçüncü taraf API'lerine ve hizmetlerine çağrı yaparak vb. API proxy'nizin davranışını özelleştirebilirsiniz. Daha fazla bilgi için API'leri ve API proxy'lerini anlama başlıklı makaleyi inceleyin.
Node.js geliştiricisiyseniz Node.js modüllerinizi Edge'e sorunsuz bir şekilde ekleyerek API'ler ve API mashup'ları oluşturabilir, mesaj dönüştürme, güvenlik ve analiz gibi Edge'in sunduğu avantajlardan yararlanabilirsiniz.
Uç izleme ve analiz
Apigee Edge API Analytics, API'lerinizin kısa ve uzun vadeli kullanım trendlerini görmenizi sağlayan güçlü araçlar sunar. Kitlenizi en iyi geliştiricilere ve uygulamalara göre segmentlere ayırabilir, yatırım yapacağınız yerleri belirlemek için API yöntemine göre kullanımı anlayabilir ve işletme veya operasyonel düzeydeki bilgilerle ilgili özel raporlar oluşturabilirsiniz.
Veriler Edge'den geçerken URL, IP, API çağrısı bilgileri için kullanıcı kimliği, gecikme, hata verileri vb. dahil olmak üzere çeşitli varsayılan bilgi türleri toplanır. XML veya JSON'dan çıkarılan üstbilgiler, sorgu parametreleri ve istek ya da yanıt bölümleri gibi başka bilgiler eklemek için politikalar oluşturabilirsiniz. Bu bilgiler, gerçek istek/yanıt akışından eşzamansız olarak toplandığı için API performansı üzerinde herhangi bir etkisi yoktur.
Yönetim kullanıcı arayüzü, aşağıdaki şekilde gösterildiği gibi bir tarayıcıda birden fazla metrik ve boyutu görüntülemenize olanak tanır:
Ancak Analytics Hizmeti'ne komut satırı arayüzü veya RESTful API'ler aracılığıyla da erişip kontrol edebilirsiniz. Daha fazla bilgi için API analizlerine genel bakış başlıklı makaleyi inceleyin.
Edge geliştirici ekosistemi
Apigee Edge, geliştiricilere aşağıdaki olanakları sunan hizmetler sağlar:
- Hizmetlerinizi kullanan uygulama geliştiricilerden oluşan topluluğu yönetin.
- Dahili ve harici geliştiricilerle çalışın ve ilişkileri finansal modellerle resmileştirin.
- Geliştiricilerin ilgisini çekin ve geliştirici portalı oluşturun. Uygulama geliştiriciler, herkese açık API ürünleriniz hakkında daha fazla bilgi edinmek ve API anahtarlarını yönetmek için API belgelerine erişmek üzere portalınıza bağlanır.
Her Edge müşterisi, bulutta veya Apigee Edge for Private Cloud ile şirket içinde kendi geliştirici portalını oluşturabilir.
Apigee Edge, iki tür portal oluşturmanıza olanak tanır:
- Anında sağlanan entegre portal Entegre portalınızı oluşturma başlıklı makaleyi inceleyin.
- Drupal tabanlı portal. Drupal tabanlı bir portal oluşturma başlıklı makaleye bakın.
Para kazanma
Para kazanma özellikleri, geliştirici topluluğunuzu dijital öğeleriniz için gerçek bir kanala dönüştürmek üzere finansal altyapı ve ilişkiler sağlar. Para kazanma özelliğiyle API ürünlerinizin kullanımı için geliştiricilerden ücret alan çeşitli ücret planları oluşturabilir veya gelir paylaşımı senaryolarında geliştiricilere ödeme yapabilirsiniz.
Planlar arasında ön ödemeli planlar, sonradan ödemeli planlar, sabit ücretli planlar, değişken ücretli planlar, "freemium" planlar, belirli geliştiricilere özel planlar, geliştirici gruplarını kapsayan planlar ve daha fazlası yer alır. Ayrıca, para kazanma özelliği raporlama ve faturalandırma olanaklarını da içerir.
Daha fazla bilgi için Para kazanmaya genel bakış başlıklı makaleyi inceleyin.
Edge'in özellikleri
Apigee Edge'in aşağıdaki sürümleri vardır:
- Herkese açık bulut: Apigee'nin ortamı koruduğu, barındırılan bir SAAS sürümü. Bu sürüm, hizmetlerinizi oluşturmaya ve bu hizmetlere yönelik API'leri tanımlamaya odaklanmanızı sağlar.
- Private Cloud: Donanım ortamını kontrol ettiğiniz ve kurulum, yükseltme, bakım ve diğer yönetim süreçlerinden sorumlu olduğunuz şirket içi bir kurulumdur.
Apigee Hybrid sürümümüzle ilgileniyorsanız aşağıdaki Apigee X konularına göz atın:
İşlevsel olarak, Public Cloud ve Private Cloud sürümleri birbirine çok benzer. Ancak Private Cloud sürümü, Public Cloud sürümünün tüm özelliklerini desteklemez. Özel bulut tarafından desteklenmeyen özellikler şunlardır:
- Barındırılan hedefler
- Uzantılar
- Entegre geliştirici portalları (Not: Drupal tabanlı geliştirici portalları desteklenir)
- API izleme
- Sense
Paketler arasındaki farkların listesi için Apigee ürünlerini karşılaştırma başlıklı makaleyi inceleyin.
Edge for Public Cloud API ile Private Cloud API arasındaki farklar başlıklı makalede açıklandığı gibi API'ler arasında küçük farklar da vardır.
Public Cloud hem ücretsiz hem de ücretli hesapları destekler. Private Cloud için ücretli hesaplar gerekir.
Şirket içi kurulumu tam olarak desteklemek için Private Cloud sürümünde Apigee yönetim sunucusu, Apache Cassandra NoSQL veritabanı, OpenLDAP sunucusu, mesaj yönlendirici ve mesaj işlemcisi gibi bileşenler bulunur.