Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Apigee Edge, API'leri geliştirmek ve yönetmek için kullanılan bir platformdur. Edge, hizmetlere proxy katmanıyla ön plana çıkarak arka uç hizmeti API'leriniz için bir soyutlama veya yüzey sağlar; güvenlik, hız sınırlama, kotalar, analizler ve daha fazlasını sunar.
Örneğin, fotoğraf baskısı, reçete ve sağladığı diğer hizmetler konusunda zengin bir uygulama ekosistemi sunmak için Walgreens'in API'leri ve Apigee Edge'i nasıl kullandığıyla ilgili bir web yayınını izleyebilirsiniz.
Dijital hızlandırma
Bu videoda, Apigee'nin dijital bir işletmeye dönüşmenize nasıl yardımcı olduğuna hızlıca göz atabilirsiniz.
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ıma sunmak ve bu hizmetlerin mobil cihazlarda ve masaüstü bilgisayarlarda çalışan uygulamalar tarafından kullanılabilmesini sağlamak istiyor. Bir şirket; ürün fiyatlandırması ve stok durumu bilgilerini, satış ve sipariş hizmetlerini, sipariş takibi hizmetlerini ve müşteri uygulamalarının gerektirdiği diğer hizmetleri sağlayan hizmetleri sergilemek isteyebilir.
Şirketler, hizmetleri genellikle bir dizi HTTP uç noktası olarak sunar. Daha sonra istemci uygulaması geliştiricileri, bu uç noktalara HTTP istekleri gönderir. Uç noktaya bağlı olarak hizmet, verileri XML veya JSON olarak biçimlendirilmiş şekilde istemci uygulamasına döndürebilir.
Bu hizmetleri kullanan istemci uygulamaları, bir mobil cihaz veya tablet için bağımsız uygulamalar, tarayıcıda çalışan HTML5 uygulamaları ya da HTTP uç noktasına istek gönderip tüm yanıt verilerini tüketebilen başka herhangi bir uygulama türü olarak uygulanabilir. Bu uygulamalar, hizmetleri kullanıma sunan aynı şirket veya herkese açık hizmetlerden yararlanan üçüncü taraf uygulama geliştiricileri tarafından geliştirilip yayınlanabilir.
Aşağıdaki resimde bu model türü gösterilmektedir:
Sağlayıcılar, hizmetlerini web üzerinden kullanıma sunduğundan, hizmetlerini yetkisiz erişime karşı güvence altına almak ve korumak için gerekli tüm adımları attıklarından emin olmalıdırlar. 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 onları nasıl izleyebilirsiniz?
- Para kazanma: Hizmetlerinize erişimleri için müşterileri nasıl izleyebilir ve faturalandırabilirsiniz?
- Dikkat edilmesi gereken diğer noktalar
Herhangi bir hizmete erişen bir istemci uygulaması yayınlandıktan sonra, servis sağlayıcının bu hizmetleri eklerken, değiştirirken veya silerken söz konusu hizmetlerin zaman içinde çalışmaya devam ettiğinden emin olması gerekir. Servis sağlayıcı ayrıca, istemci uygulamalarının bu hizmetlerle senkronize olmasını sağlamak için uygulama geliştiricileri hizmetlerde yapılan değişikliklerden haberdar etme imkanına sahip olmalıdır.
Müşteri uygulaması geliştiricileri, farklı sağlayıcıların hizmetlerini kullanmaya çalışırken sorunlarla karşılaşır. Günümüzde bir servis sağlayıcının, hizmetlerini sunmak için kullanabileceği birçok teknoloji vardır. Aynı istemci uygulamasının, bir sağlayıcının sunduğu hizmeti tüketmek için bir mekanizma kullanması, farklı bir sağlayıcının sunduğu hizmeti tüketmek için de farklı bir mekanizma kullanması gerekebilir. Uygulama geliştiriciler, aynı sağlayıcının sunduğu hizmetleri tüketmek için farklı mekanizmalar kullanmak zorunda kalabilecekleri durumlarla bile karşı karşıya kalabilir.
Apigee Edge üzerinden hizmetleri kullanıma sunun
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.
- Genel API'yi etkilemeden arka uç hizmeti uygulamasını değiştirmenizi sağlar.
- Analiz, para kazanma, geliştirici portalı ve Edge'de yerleşik olarak bulunan diğer özelliklerden yararlanmanızı sağlar.
Aşağıdaki resimde, istemci uygulamalarından arka uç hizmetlerinize gelen istekleri işleyen Edge'in bulunduğu bir mimari gösterilmektedir:
Uygulama geliştiricilerinin hizmetlerinizi doğrudan kullanmalarını sağlamak yerine, Edge'de oluşturulan bir API proxy'sine erişirler. API proxy'si, herkese açık bir HTTP uç noktasının arka uç hizmetinize eşlenmesi olarak işlev görür. API proxy'si oluşturarak Edge'in hizmetlerinizi korumak, bu hizmetleri analiz etmek, izlemek ve bunlardan para kazanmak için gereken güvenlik ve yetkilendirme görevlerini yönetmesine izin verirsiniz.
Uygulama geliştiriciler doğrudan hizmetleriniz yerine API proxy'sine HTTP istekleri yaptığından, geliştiricilerin hizmetlerinizin uygulanması hakkında herhangi bir şey bilmesi gerekmez. Geliştiricinin bilmesi gereken tek şey şudur:
- API proxy uç noktasının URL'si.
- Bir istekte iletilen sorgu parametreleri, başlıklar veya gövde parametreleri.
- Gerekli kimlik doğrulama ve yetkilendirme kimlik bilgileri.
- Yanıt veri biçimi de dahil olmak üzere yanıtın biçimi (ör. XML veya JSON).
API proxy'si, uygulama geliştiriciyi arka uç hizmetinizden ayırır. Bu nedenle, genel API tutarlı olduğu sürece hizmet uygulamasını değiştirebilirsiniz. Tutarlı bir ön uç API'si koruyarak, arka uçtaki değişikliklerden bağımsız olarak mevcut istemci uygulamaları çalışmaya devam eder.
Arka uç hizmetinde değişiklik yapmak zorunda kalmadan bir hizmete işlev eklemek için API proxy'sindeki politikaları kullanabilirsiniz. Örneğin, veri dönüşümleri ve filtreleme işlemleri gerçekleştirmek, güvenlik eklemek, koşullu mantık veya özel kod yürütmek ve daha birçok işlem gerçekleştirmek için proxy'nize politikalar ekleyebilirsiniz. Unutulmaması gereken önemli 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 bölümüne bakın.
API ürünü oluşturma
API proxy'si, geliştiricilerin arka uç hizmetlerinize erişmek için Apigee Edge'de kullandığı HTTP uç noktasıdır. Mümkün olsa da genellikle tek tek API proxy'lerini kullanıma sunmayız. Bunun yerine, bir veya daha fazla API proxy'sini bir API ürünü altında gruplandırırsınız.
API ürünü, bir hizmet planıyla birlikte kullanılan bir API proxy'si paketidir. Bu hizmet planı; API proxy'leri üzerinde erişim sınırları belirleyebilir, güvenlik sağlayabilir, izleme ve analize imkan tanıyabilir ve ek özellikler sunabilir. API ürünleri aynı zamanda Edge'in API'lerinize yönelik yetkilendirme ve erişim kontrolü için kullandığı merkezi mekanizmadır.
API ürünleri oluştururken oldukça fazla 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 3'e erişime izin verdiğine, ancak yalnızca A ürününün, API proxy 1'e erişime izin verdiğine dikkat edin.
Her API ürününde farklı özellikler ayarlayabilirsiniz. Örneğin, erişim sınırı düşük olan bir API ürününü (ör. günde 1.000 istek) uygun bir fiyatla kullanıma sunabilirsiniz. Daha sonra daha yüksek bir fiyat karşılığında 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ınlarsınız. Alternatif olarak, hizmetlerinize salt okuma erişimi sağlayan ücretsiz bir API ürünü oluşturabilir ve ardından okuma/yazma erişimine izin veren aynı API proxy'lerine bir API ürünü satabilirsiniz.
Daha fazla bilgi için API ürünlerini yönetme başlıklı makaleyi inceleyin.
İstemci taraflı uygulamanın API ürününüze erişmesine izin verme
Uygulama geliştiriciler hizmetlerinize erişmek istediklerinde öncelikle istemci uygulamalarını API ürününüze kaydetmeleri gerekir.
Uygulama geliştirici, kayıt sonrasında API ürününe dahil olan bir API proxy'sine yapılan her isteğe dahil etmesi 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.
İstemci uygulamasının hizmetlerinize artık erişememesi için anahtarı istediğiniz zaman iptal edebilirsiniz. Alternatif olarak, geliştiricinin anahtarı belirli bir süre sonra yenilemesi için anahtarda süre sınırı tanımlayabilirsiniz.
API ürünlerinize erişmek için geliştiricilerin kayıt isteklerini nasıl ele alacağınıza siz karar verirsiniz. Apigee Edge Developer Services'ı kullanarak kayıt işlemini otomatik hale getirebilir veya erişimi kontrol etmek için manuel işlem kullanabilirsiniz.
API ürünleri oluşturma ve bunları geliştiricilerin kullanımına sunma
- Herkese açık URL'leri arka uç hizmetlerinizle 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ılabilir olduğunu bildirin.
Uygulama geliştiriciler, API ürününüzün kullanılabilirliği hakkında bilgi edindikten sonra:
- İstemci uygulamalarını sizin API ürününüze kaydetme
- API ürünü için bir API anahtarı alın.
- API proxy'leri (API ürününde paket halinde sunulur) üzerinden hizmetlerinize istekte bulunun ve her istekte API anahtarını iletin.
Apigee Edge'in bileşenleri
Apigee Edge; API çalışma zamanı, izleme ve analizinin yanı sıra geliştirici hizmetlerinden oluşur. Bu hizmetler birlikte API oluşturma, güvenlik, yönetim ve işlemler için kapsamlı bir altyapı sunar.
Aşağıdaki şekilde Edge hizmetleri gösterilmektedir:
Edge API çalışma zamanı
İster bir servis sağlayıcı olarak API proxy'leri oluşturun ister uygulama geliştiricisi olarak API'ler, SDK'lar ve diğer kolaylık hizmetlerini kullanın, Apigee Edge API Hizmetleri tamamen API oluşturma ve kullanma ile ilgilidir.
API yönetimi sunucusu; API proxy'lerinizi ekleyip yapılandırmak, API ürünlerini ayarlamak ve uygulama geliştiriciler ile istemci uygulamalarını yönetmek için araçlar sağlar. Arka uç hizmetlerinizden birçok yaygın yönetim endişesini azaltır. Bir API proxy'si eklediğinizde güvenlik, hız sınırlama, uyumlulaştırma, önbelleğe alma ve benzerleri eklemek için API proxy'sine politikalar uygulayabilirsiniz. Özel komut dosyaları uygulayarak, üçüncü taraf API'lerine ve hizmetlerine çağrı yaparak ve benzeri işlemler yaparak API proxy'nizin davranışını da özelleştirebilirsiniz. Daha fazla bilgi için API'leri ve API proxy'lerini anlama bölümüne bakın.
Node.js geliştiricisiyseniz API'ler ve API mashup'ları oluşturmak için Node.js modüllerinizi Edge'e kolayca ekleyebilirsiniz. Tüm bunları yaparken de mesaj dönüştürmeden güvenlik ve analize kadar 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örmek için güçlü araçlar sunar. Kitlenizi en iyi geliştiricilere ve uygulamalara göre segmentlere ayırabilir, nereye yatırım yapacağınızı öğrenmek için API yöntemine göre kullanımı anlayabilir ve işletme veya operasyon düzeyindeki bilgiler hakkında özel raporlar oluşturabilirsiniz.
Veriler Edge'den geçerken URL, IP, API çağrı bilgileri için User-ID, gecikme, hata verileri vb. dahil olmak üzere çeşitli varsayılan bilgi türleri toplanır. Üstbilgiler, sorgu parametreleri ve XML veya JSON'dan çıkarılan bir 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 toplanır ve bu nedenle 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 çok metriği ve boyutu görüntülemenizi sağlar:
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 Analytics'e genel bakış sayfasını inceleyin.
Uç geliştirici ekosistemi
Apigee Edge, şunları yapabilmenizi sağlayan geliştirici hizmetleri sağlar:
- Hizmetlerinizi kullanan uygulama geliştiricilerden oluşan topluluğu yönetin.
- Şirket içi ve şirket dışı geliştiricilerle çalışma ve finansal modellerle ilişkileri resmi bir hale getirme.
- Geliştiricilerin katılımını sağlayın ve bir geliştirici portalı oluşturun. Uygulama geliştiriciler, herkese açık API ürünleriniz hakkında daha fazla bilgi edinmek ve API anahtarlarınızı yönetmek üzere API belgelerine erişmek için portalınıza bağlanır.
Her Edge müşterisi, Private Cloud için Apigee Edge ile bulutta veya şirket içinde kendi geliştirici portalını oluşturabilir.
Apigee Edge sayesinde iki tür portal oluşturabilirsiniz:
- Anında temel hazırlığı yapabilen entegre portal. Entegre portalınızı oluşturma başlıklı makaleyi inceleyin.
- Drupal tabanlı portal. Drupal tabanlı portal oluşturma başlıklı makaleyi inceleyin.
Para kazanma
Para kazanma özellikleri, geliştirici topluluğunuzu dijital öğeleriniz için gerçek bir kanala dönüştürmek için finansal altyapı ve ilişkiler sağlar. Para kazanma özelliği sayesinde, geliştiricilerden API ürünlerinizin kullanımı için ücret alan veya gelir paylaşımı senaryolarında geliştiricilere ödeme yapmanıza olanak tanıyan çeşitli ücret planları oluşturabilirsiniz.
Planlar arasında ön ödemeli planlar, faturalı planlar, sabit ücretli planlar, değişken ücretli planlar, "freemium" planlar, belirli geliştiricilere göre uyarlanmış planlar, geliştirici gruplarını kapsayan planlar ve daha fazlası yer alır. Ayrıca, para kazanma özellikleri raporlama ve faturalandırma özelliklerini içerir.
Daha fazla bilgi için Para kazanmaya genel bakış başlıklı makaleyi inceleyin.
Kenar Çeşitleri
Apigee Edge aşağıdaki seçeneklerle sunulur:
- Herkese Açık Bulut: Apigee'nin ortamı koruduğu, hizmetlerinizi oluşturmaya ve bu hizmetlerin API'lerini tanımlamaya odaklanabileceğiniz, barındırılan bir SAAS sürümü.
- Private Cloud: Donanım ortamını kontrol ettiğiniz ve kurulum, yükseltme, bakım ve diğer idari işlemlerden sorumlu olduğunuz şirket içi bir kurulum.
Apigee Hibrit sürümümüzle ilgileniyorsanız aşağıdaki Apigee X konularını inceleyin:
İş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. Private Cloud 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
Tatlar arasındaki farklılıkların listesini görmek için Apigee ürünlerini karşılaştırma bölümüne bakın.
Herkese Açık Cloud API için Edge ve Private Cloud API arasındaki farklar bölümünde açıklandığı üzere API'ler arasında küçük farklar da vardır.
Public Cloud, hem ücretsiz hem de ücretli hesapları destekler. Private Cloud'un kullanılabilmesi için ücretli hesaplar gerekir.
Private Cloud sürümü, şirket içi yüklemeyi tam olarak desteklemek için Apigee yönetim sunucusu, Apache Cassandra GPC veritabanı, OpenLDAP sunucusu, mesaj Yönlendiricisi ve Mesaj İşleyici gibi bileşenler içerir.