Amazon API Gateway ile API'ler oluşturma

AWS'de Uygulama Dağıtımı

Dunieski Otano

Amazon Web Services Solutions Architect

Üç istemci, tek arka uç

Web, mobil ve bir iş ortağı aynı arka uca çağrı yapıyor
Her biri biraz farklı bir format konuşuyor
Bir ön kapı her çağıranı doğrular ve dönüştürür

Tek bir API Gateway üzerinden bağlanan üç istemci türü; istekleri arka uç servislere yönlendirir

API Gateway ne yapar

Yönetilen bir ön kapı olarak API Gateway: web ve mobil istemciler yönlendirme, kimlik doğrulama, hız sınırlama ve dönüştürme özellikleriyle Lambda, HTTP uç noktaları ve AWS hizmetlerine giden merkezi bir ağ geçidinden geçer

API'lerin için tamamen yönetilen bir ön kapı
Yönlendirme, yetkilendirme, hız sınırlama ve dönüşümü yönetir
İstemcilerle arka uç arasında durur
Arka uçlar: Lambda, HTTP uç noktaları veya AWS hizmetleri

Entegrasyon türleri

Lambda proxy: tüm isteği Lambda'ya geçirir
Lambda proxy olmayan: istek ve yanıt alanlarını sen eşlersin
HTTP: bir HTTP arka ucuna iletir
MOCK: hiç arka uç olmadan yanıt döner

Dört API Gateway entegrasyon türü: tüm isteği ileten Lambda proxy, eşleme şablonları kullanan Lambda proxy olmayan, bir uç noktaya ileten HTTP ve sabit yanıt dönen MOCK

İstek ve yanıt dönüşümleri

Eşleme şablonları yükleri VTL ile yeniden şekillendirir
Velocity Template Language gövdeyi, üstbilgileri, parametreleri dönüştürür
İstek eşleme: istemci formatından arka uca
Yanıt eşleme: arka uç formatından istemciye

VTL eşleme şablonu akışı: istemci yükü arka uca gitmeden önce istek şablonuyla dönüştürülür, ardından arka uç yanıtı istemciye dönmeden önce yanıt şablonuyla dönüştürülür

İstek doğrulama

İstek doğrulama modları: gövdeyi JSON şemaya göre doğrula, gerekli sorgu ve üstbilgi parametrelerini doğrula ya da Lambda arka ucu çağrılmadan önce her ikisini de doğrula

Kötü girdiyi arka uca ulaşmadan önce reddet
Gerekli parametreler: üstbilgiler, sorgu dizeleri, yollar
Model şemaları: JSON gövde yapısını doğrula
Gövdeyi, parametreleri ya da her ikisini doğrula

Durum kodları ve hata sözleşmeleri

Tutarlı bir sözleşme için arka uç durum kodlarını geçersiz kıl
Arka uç 502'yi istemciler için temiz bir 503'e eşle
Ağ geçidi yanıtları: hata gövdelerini özelleştir
İstemciler arka uçtan bağımsız öngörülebilir hatalar alır

Tam API Gateway istek yaşam döngüsü: doğrulama kötü girdiyi kapıda reddeder, eşleme şablonu geçerli girdiyi arka uç için yeniden şekillendirir, yanıt şablonu çıktıyı tutarlı bir istemci sözleşmesine uyarlar

Hepsini bir araya getirelim

İstemci isteği → doğrulama → dönüşüm → arka uç
Kötü girdi kapıda reddedilir
İyi girdi arka uç için yeniden şekillendirilir
Arka uç yanıtı istemci sözleşmesine uyarlanır

Hadi pratik yapalım!

AWS'de Uygulama Dağıtımı