Amazon API Gateway Hakkında SSS

Amazon API Gateway, yazılım geliştiriciler tarafından istenen ölçekte API yayımlanmasını, API’lerin izlenmesini, bakımının yapılmasını ve güvenliğinin sağlanmasını mümkün kılan, tam olarak yönetilen bir hizmettir. AWS Management Console'da birkaç tıklamayla uygulamalarınızın arka uç hizmetlerinizdeki (Amazon Elastic Compute Cloud (Amazon EC2), Amazon Elastic Container Service (Amazon ECS) veya AWS Elastic Beanstalk üzerinde çalışan uygulamalar, AWS Lambda üzerinde çalışan kod veya herhangi bir web uygulaması) verilere, iş mantığına ya da işlevlere erişmesi için "ön kapı" görevi gören bir API oluşturabilirsiniz. Amazon API Gateway, yüz binlerce API çağrısının kabul edilip işlenmesi için gerekli olan trafik yönetimi, yetkilendirme ve erişim denetimi, izleme, API sürüm yönetimi dahil olmak üzere tüm görevleri üstlenir. Amazon API Gateway'de minimum ücret veya peşin maliyet yoktur. HTTP API'leri ile REST API'leri için yalnızca aldığınız API çağrıları ve dışarı aktarılan veri miktarı karşılığında ücret ödersiniz. WebSocket API'lerde sadece gönderilen ve alınan mesajlar için ve bir kullanıcının/cihazın WebSocket API'ye bağlı kaldığı süre için ücret ödersiniz.

Amazon API Gateway, geliştiricilere uygulama arka uçları için sağlam API’ler oluşturup çalıştırmanın tüm boyutlarını üstlenen basit, esnek, tam olarak yönetilen ve kullandıkça ödeme modeliyle sunulan bir hizmet sağlar. API Gateway ile yeni hizmetlerinizi daha hızlı bir şekilde ve daha az yatırımla hayata geçirerek temel iş hizmetlerinizi geliştirmeye odaklanabilirsiniz. API Gateway, API oluşturma ve yönetme sürecinin çeşitli boyutları konusunda size yardımcı olacak şekilde tasarlanmıştır:

1) Ölçüm. API Gateway, üçüncü taraf yazılım geliştiricilerin API’lerinize erişimini ölçen ve kısıtlayan planlar tanımlamanıza yardımcı olur. API anahtarı başına olacak şekilde bir dizi plan tanımlayabilir, azaltma ve kota sınırları yapılandırabilirsiniz. API Gateway, API’lerinize yönelik trafiği otomatik olarak ölçer ve her API anahtarı için kullanım verilerini ayıklamanıza olanak tanır.

2) Güvenlik. API Gateway, API'lerinize erişimi yetkilendirmek ve hizmet operasyon erişimini denetlemek için kullanabileceğiniz birden çok araç sağlar. API Gateway ile AWS Identity and Access Management (IAM) ve Amazon Cognito gibi AWS yönetim ve güvenlik araçlarından yararlanarak API'lerinize erişimi yetkilendirebilirsiniz. API Gateway, AWS'nin kendi API'leri için kullandığı metodolojiden yararlanarak imzalı API çağrılarını sizin adınıza doğrulayabilir. API Gateway, AWS Lambda işlevleri olarak yazılmış özel yetkilendiricileri kullanarak gelen taşıyıcı belirteçleri doğrulamanıza da yardımcı olduğundan, arka uç kodunuzda yetkilendirmeyle ilgili endişeleri ortadan kaldırır.

3) Dayanıklılık. API Gateway, arka uç işlemlerinin ani trafik artışlarına karşı dayanıklı olması için azaltma yöntemiyle trafiği yönetmenize yardımcı olur. API Gateway ayrıca API çağrılarının çıktısını önbelleğe kaydedip her seferinde arka uç sistemlerinize çağrı yapılmasını engelleyerek API'lerinizin performansını ve son kullanıcılarınızın yaşadığı gecikme süresini iyileştirmenize yardımcı olur.

4) Operasyonları İzleme. Bir API yayımlanıp kullanıma girdikten sonra, API Gateway hizmetlerinize yapılan çağrıları izleyebileceğiniz bir ölçüm panosu sağlar. API Gateway panosu, Amazon CloudWatch entegrasyonu aracılığıyla API çağrıları, gecikme süresi verileri ve hata oranlarını kapsayan arka uç performans ölçümleri sağlar. API’lerinizdeki her bir yöntem için ayrıntılı ölçümleri etkinleştirebilir, ayrıca CloudWatch Logs’da hata, erişim veya hata ayıklama günlükleri alabilirsiniz.

5) Yaşam Döngüsü Yönetimi. Bir API yayımlandıktan sonra genellikle işlevleri geliştiren ya da yeni işlevler ekleyen yeni sürümler oluşturup bunları test etmeniz gerekir. API Gateway, yeni API sürümleri yayımlandıktan sonra mevcut uygulamaların önceki sürümlere çağrı yapmaya devam edebilmesi için birden çok API sürümünü ve her sürümün birden çok aşamasını eş zamanlı olarak çalıştırmanıza olanak tanır.

6) Yazılım Geliştiriciler İçin Tasarlandı. API Gateway, hızla API oluşturup API’lerin yanıtlarına statik içerikler atayarak ekipler arası geliştirme iş yükünü ve uygulamalarınızın pazara sunulma süresini azaltmanıza olanak tanır. Siz arka uç süreçlerinizi oluşturduğunuz sırada, API’lerinize gereksinim duyan ekipler geliştirme sürecine başlayabilir.

7) Gerçek Zamanlı Çift Yönlü İletişim. Herhangi bir sunucu çalıştırmanız veya yönetmeniz gerekmeden sohbet uygulamaları, akış panoları ve bildirimler gibi gerçek zamanlı çift yönlü iletişim uygulamaları oluşturun. API Gateway, bağlı kullanıcılar arasında kalıcı bir bağlantı sağlar ve aralarında mesaj iletimi yapmalarına olanak tanır.

Amazon API Gateway, HTTP API'leri ve REST API'leri olmak üzere RESTful API'leri oluşturmak için iki seçeneğin yanı sıra WebSocket API'leri oluşturma seçeneği sunar.

HTTP API'si: HTTP API'leri, AWS Lambda işlevleri veya HTTP arka uçları için proxy görevini yerine getiren API'ler oluşturmak için optimize edilmiştir ve bu nedenle, sunucusuz iş yükleri için idealdir. Şu anda API yönetim işlevselliği sunulmamaktadır.

REST API'si: REST API'leri, API proxy'si işlevlerini ve yönetim özelliklerini tek bir çözüm halinde sunar. REST API'ler; kullanım planları, API anahtarları, API yayınlama ve API'lerden para kazanma gibi API yönetim özellikleri sunar.

WebSocket API'si: WebSocket API'leri gerçek zamanlı mesaj iletişimini sağlamak üzere bağlı istemciler arasında kalıcı bağlantıyı korur. API Gateway'deki WebSocket API'ler sayesinde bağlı istemcilerden mesaj geldiğinde çağrı almak için AWS Lambda işlevleri, Amazon Kinesis veya herhangi bir HTTP uç noktası ile arka uç entegrasyonları tanımlayabilirsiniz.

HTTP API'leri kullanmaya başlamak için Amazon API Gateway konsolu, AWS CLI, AWS SDK'ları veya AWS CloudFormation'ı kullanabilirsiniz. HTTP API'leri kullanmaya başlama hakkında daha fazla bilgi edinmek için belgeler bölümümüzü ziyaret edin.

REST API'leri kullanmaya başlamak için Amazon API Gateway konsolu, AWS CLI veya AWS SDK'larını kullanabilirsiniz. REST API'leri kullanmaya başlama hakkında daha fazla bilgi edinmek için belgeler bölümümüzü ziyaret edin.

Amazon API Gateway'deki HTTP API'leri ve REST API'leri kullanarak RESTful API'leri oluşturabilirsiniz.

HTTP API'ler, AWS Lambda işlevleri veya HTTP arka uçları için proxy oluşturan API'ler sağlamak için optimize edilmiştir. Bu nedenle, sunucusuz iş yükleri için idealdirler. HTTP API'ler, REST API'lere göre daha uygun fiyatlı ve daha hızlı bir alternatiftir. Ancak, şu anda API yönetimi işlevlerini desteklememektedir. REST API'ler, tek bir çözümde API proxy'si işlevlerine ve API yönetim özelliklerine ihtiyaç duyan API'lere yöneliktir.

HTTP API'ler şunlar için idealdir:

1. AWS Lambda veya herhangi bir HTTP uç noktası için proxy API'leri oluşturma
2. OIDC ve OAuth 2 yetkilendirmesi ile donatılmış modern API'ler oluşturma 
3. Çok fazla büyüme ihtimaline sahip iş yükleri
4. Gecikme süresine duyarlı iş yüklerine yönelik API'ler

1. API'lerini oluşturmak, yönetmek ve yayınlamak için ihtiyaç duyulan tam kapsamlı bir özellik grubu için tek bir fiyat ödemek isteyen müşteriler. 

HTTP API'ler, kimlik doğrulama ve yetkilendirme ile aşamalı otomatik dağıtımlar için standart olarak CORS desteği, OIDC ve OAuth2 desteği ile birlikte gelir.

Evet, OpenAPI 3'ü kullanarak bir API tanımını içe aktarabilirsiniz. Bu da yolların, entegrasyon ve API modellerinin oluşturulmasını sağlar. OpenAPI tanımlarını içe aktarma hakkında daha fazla bilgi için belgeler bölümümüze bakın.

Mevcut REST API'nizden Amazon API Gateway'deki bir HTTP API'ye geçiş yapmak için aşağıdaki işlemleri gerçekleştirin:

1. İhtiyacınız olan tüm özelliklerin HTTP'de mevcut olup olmadığını kontrol edin. Tüm özelliklerin listesini görmek için belgeler bölümümüzü ziyaret edin. 
2. REST API'nize gidin ve REST API'nizdeki OpenAPI tanımını dışa aktarın
3. HTTP API'nize gidin ve bir önceki adımda belirtilen OpenAPI tanımını içe aktarın
4. API işlevlerinin beklendiği gibi çalıştıklarından emin olun
5. Sunucularınızı yeni URL ile güncelleyin

API'niz çalışırken bazı özelliklerin eksik olduğunu fark edebilirsiniz. Eksik özellikleri tanımlamak için İçeri Aktarma işlemindeki Bilgi, Uyarı ve Hata alanlarını kontrol edin. REST API'leri HTTP API'lere geçirme hakkında daha fazla bilgi için belgeler bölümümüze bakın.

Öncelikle, REST'inize gidin ve REST API'deki OpenAPI tanımını dışa aktarın. Ardından, HTTP API'nize gidin ve bir önceki adımda belirtilen OpenAPI tanımını içe aktarın. API'niz çalışırken bazı özelliklerin eksik olduğunu fark edebilirsiniz. Eksik özellikleri tanımlamak için İçeri Aktarma işlemindeki Bilgi, Uyarı ve Hata alanlarını kontrol edin. AWS CLI, bilgi ve uyarı alanlarınızda API'niz hakkındaki bilgileri döndürecektir. Daha fazla bilgi için belgeler bölümümüzü okuyun.

Başlamak için, AWS Management Console, AWS CLI veya AWS SDK’ları kullanarak WebSocket API oluşturabilirsiniz. Daha sonra, mesaj içeriğine bağlı olarak çağrı almak için AWS Lambda, Amazon Kinesis veya kendi HTTP uç noktanız gibi arka uç hizmetlerini göstermesi için WebSocket yönlendirmesini ayarlayabilirsiniz. API Gateway’deki WebSocket API’leri başlatmak için belgelere bakın.

Evet, Amazon API Gateway ile oluşturulan tüm API’ler yalnızca HTTPS uç noktaları sunar. Amazon API Gateway, şifrelenmemiş (HTTP) uç noktaları desteklemez. Varsayılan olarak, Amazon API Gateway tarafından API’ye otomatik olarak Amazon API Gateway sertifikasını kullanan dahili bir etki alanı atanır. API’lerinizi özel bir etki alanı altında çalışacak şekilde yapılandırırken etki alanı için kendi özel sertifikanızı sağlayabilirsiniz.

Amazon API Gateway'de oluşturulan API'ler; HTTP API'ler, REST API'ler ve WebSocket API'ler için HTTPS üzerinden gönderilen tüm yükleri kabul edebilir. Yaygın olarak kullanılan biçimler arasında JSON, XML, sorgu dizesi parametreleri ve istek üst bilgileri yer alır. API'lerinizin yanıtları için dilediğiniz türde içerik belirtebilir, daha sonra dönüştürme şablonlarını kullanarak arka uç yanıtını istediğiniz biçimde olacak şekilde değiştirebilirsiniz.

Amazon API Gateway, hesabınızda AWS Lambda işlevleri yürütebilir, AWS Step Functions durum makineleri başlatabilir veya AWS Elastic Beanstalk ve Amazon EC2’de barındırılan HTTP uç noktalarının yanı sıra AWS’de barındırılmayan, genel internet aracılığıyla erişilebilen HTTP tabanlı işlemlere çağrı yapabilir. API Gateway ayrıca döndürülecek statik içeriği oluşturmak için bir eşleme şablonu belirtmenize olanak tanıyarak arka uç hazır olmadan önce API’lerinizi denemenize yardımcı olur. Ayrıca, API Gateway’i diğer AWS hizmetlerine doğrudan entegre edebilir, örneğin API Gateway’de verileri doğrudan Amazon Kinesis’e gönderen bir API yöntemi sunabilirsiniz.

API Gateway, Android ve iOS (Swift ve Objective-C) ile mobil uygulama, JavaScript ile web uygulaması geliştirmeye yönelik özel SDK’lar oluşturur. API Gateway, Ruby ve Java için SDK oluşturulmasını da destekler. API Gateway’de bir API ve bu API’nin modelleri tanımlandıktan sonra, AWS konsolunu ya da API Gateway API’lerini kullanarak bir istemci SDK’sı oluşturabilir ve SDK’yı indirebilirsiniz. Amazon API Gateway’de istemci SDK’ları sadece REST API’ler için oluşturulur.

HTTP API'leri, REST API'leri ve WebSocket API'lerine hangi bölgelerde erişilebildiğini görmek için buradaki AWS bölge tablosuna göz atın.

Amazon API Gateway konsolu aracılığıyla REST API’yi ve bununla ilgili kaynakları belirleyebilir, API yaşam döngüsünü yönetebilir, istemci SDK’ları oluşturabilir ve API ölçümlerini görüntüleyebilirsiniz. Ayrıca, API Gateway konsolunu kullanarak API’lerinizin kullanım planlarını tanımlayabilir, yazılım geliştiricilerin API anahtarlarını yönetebilir, azaltma ve kota sınırları yapılandırabilirsiniz. Bu eylemlerin tümüne API Gateway API’leri aracılığıyla da erişilebilir.

Kaynak, API’nizin etki alanının bir parçası olan ve türü belirtilen bir nesnedir. Her kaynak kendisiyle ilişkili bir veri modelinin yanı sıra diğer kaynaklarla ilişkilere sahip olabilir ve farklı yöntemlere yanıt verebilir. Ayrıca, birden çok alt kaynağa yönelik isteklere müdahale etmek için kaynakları değişken olarak tanımlayabilirsiniz.

Bir REST API’nin içindeki her yöntem, standart HTTP yöntemlerinden birini veya daha fazlasını destekleyebilir. Her kaynak için hangi fiillerin (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS) desteklendiğini ve bunların nasıl uygulanacağını siz tanımlarsınız. Örneğin, cars kaynağına yönelik bir GET isteği, arabaların listesini döndürmelidir. API Gateway, bir kaynaktaki tüm yöntemleri tek bir arka uç noktasına bağlamak özel bir “ANY” yöntemini de destekler.

Kullanım planları, üçüncü taraf geliştiriciler için erişimi yalnızca belirli API'lerle kısıtlayan, azaltmayı ve istek kotası sınırlarını tanımlayan planlar belirtip bunları API anahtarlarıyla ilişkilendirmenize yardımcı olur. Ayrıca, API kullanımını analiz etmek ve faturalandırma belgeleri oluşturmak için API anahtarı başına olacak şekilde kullanım verilerini ayıklayabilirsiniz. Örneğin temel, profesyonel ve kurumsal planlar oluşturabilir, temel kullanım planını günde yalnızca 1.000 isteğe ve saniyede en fazla 5 isteğe (RPS) izin verecek şekilde yapılandırabilirsiniz.

Amazon API Gateway’de her REST API’nin birden çok aşaması olabilir. Aşamalar bir API’nin geliştirme yaşam döngüsüne yardımcı olmaya yöneliktir. Örneğin, API’lerinizi oluşturduktan sonra bir geliştirme aşamasına ya da üretime hazırsanız bir üretim aşamasına dağıtabilirsiniz.

Amazon API Gateway’deki aşamalar, etiketlere benzer. Dağıtıma hangi yoldan erişilebileceğini tanımlar. Örneğin, bir geliştirme aşaması tanımlayıp cars API’nizi buna dağıtabilirsiniz Kaynağa https://www.myapi.com/dev/cars adresinden erişilebilir. Ayrıca, ek yol parametresini kullanmak zorunda kalmamak için doğrudan bir aşamayı gösteren özel etki alanı adları ayarlayabilirsiniz. Örneğin, myapi.com’u doğrudan geliştirme aşamasını gösterecek şekilde ayarladıysanız cars kaynağınıza https://www.myapi.com/cars adresinden erişebilirsiniz. Aşamalar, API yapılandırmanızdan veya eşleme şablonlarınızdan erişilebilen değişkenler kullanılarak yapılandırılabilir.

Aşama değişkenleri, bir aşamayla ilgili anahtar/değer çiftleri şeklinde yapılandırma değerleri tanımlamanıza olanak tanır. Bu değerler, ortam değişkenlerine benzer şekilde API yapılandırmanızda kullanılabilir. Örneğin, yöntem entegrasyonunuz için HTTP uç noktasını bir aşama değişkeni olarak tanımlayıp API yapılandırmanızda uç noktayı sabit kod olarak belirtmek yerine bu değişkeni kullanabilir ve bu sayede, aynı API yapılandırmasıyla her aşama (ör. geliştirme, beta, üretim) için farklı bir uç nokta kullanabilirsiniz. Eşleme şablonlarından da erişilebilen aşama değişkenleri, Lambda veya HTTP arka ucunuza yapılandırma parametrelerinin geçirilmesi için kullanılabilir.

Kaynak politikası, belirtilen bir sorumlunun (genellikle bir IAM kullanıcısı veya rolü) bir API’yi çağırıp çağıramayacağını kontrol etmek için API’ye eklediğiniz bir JSON politika belgesidir. Bir Kaynak Politikası kullanarak farklı bir AWS hesabına ait kullanıcıların API’lerinize güvenli bir şekilde erişmesine olanak tanıyabilir ya da API’nin yalnızca belirtilen kaynak IP adresi aralıklarından veya CIDR bloklarından çağrılmasına izin verebilirsiniz. Kaynak Politikaları Amazon API Gateway’deki REST API’ler ile kullanılabilir.

Amazon API Gateway, dağıtımlarınızın geçmişini kaydeder. Dilediğiniz zaman Amazon API Gateway API’lerini veya konsolu kullanarak bir aşamayı daha önceki bir dağıtıma döndürebilirsiniz.

Evet. Açık kaynak kodlu Swagger importer aracımızı kullanarak Swagger API tanımlarınızı Amazon API Gateway’e aktarabilirsiniz. Swagger importer aracı ile yeni API’ler oluşturup dağıtabileceğiniz gibi mevcut API’leri de güncelleyebilirsiniz.

API Gateway’deki API’lerinizden gelir elde etmek için API’leri AWS Marketplace’te ürün olarak yayımlayabilirsiniz. Önce AWS Marketplace’e satıcı olarak kaydolmanız ve API Gateway’deki kullanım planlarınızı ürün olarak göndermeniz gerekir. API’lerden Gelir Elde Etme hakkında daha fazla bilgi edinmek için burayı okuyun.

API Gateway, API’nizin yöntemler ve kaynaklar gibi her bir bölümüyle ilgili belgeler oluşturup bunları güncelleştirme ve silme olanağı sunar. Belgelerle ilişkili API’lere AWS SDK’ları, CLI, RESTful çağrıları aracılığıyla ya da doğrudan API Gateway konsolunda belge dizelerini düzenleyerek erişebilirsiniz. Ayrıca, belgeler API’nin bir parçası olarak veya API’den bağımsız bir şekilde içeri aktarılabildiğinden, API tanımına dokunmadan belge ekleyebilir ya da belgeleri güncelleyebilirsiniz. API Gateway, Swagger dosyalarından içeri aktarılan ya da bu biçimde dışarı aktarılan belgeler için Açık API belirtimine uygundur. API Gateway’de REST API’ler için belgeler desteklenmektedir.

API Gateway, standartlara uygun API belgeleri için destek sunmasına ek olarak belge devralmayı da desteklediğinden, bir belge dizesinin bir kez tanımlanıp birden çok yerde kullanılması basit bir işleme dönüşür. Devralma, API belgeleri tanımlama sürecini basitleştirir ve API bir Swagger dosyası olarak dışarı aktarılırken standart temsile dönüştürülebilir.

Evet, bir API’ye Kaynak Politikası uygulayarak erişimi belirli bir Amazon VPC veya VPC uç noktasıyla sınırlandırabilirsiniz. Ayrıca, bir Kaynak Politikası kullanarak farklı bir hesaptaki Amazon VPC'ye veya VPC uç noktasına Özel API'ye erişim izni verebilirsiniz.