Merancang API di AWS

Mengembangkan Aplikasi di AWS

Ricardo Sueiras

Principal Technologist

API Gateway

 

 

• Amazon API Gateway: layanan terkelola untuk membangun API.
• Rancang, deploy, kelola, dan amankan API Anda.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.
• Amankan akses ke API.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.
• Amankan akses ke API.
• Batasi laju permintaan untuk melindungi backend.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.
• Amankan akses ke API.
• Batasi laju permintaan untuk melindungi backend.
• Transformasi payload permintaan dan respons.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.
• Amankan akses ke API.
• Batasi laju permintaan untuk melindungi backend.
• Transformasi payload permintaan dan respons.
• Publikasikan API untuk konsumen.

Kemampuan Amazon API Gateway

 

• Implementasikan beragam jenis API.
• Integrasikan dengan layanan backend.
• Amankan akses ke API.
• Batasi laju permintaan untuk melindungi backend.
• Transformasi payload permintaan dan respons.
• Publikasikan API untuk konsumen.
• Kelola siklus hidup API: versioning, deployment, alias.

Jenis API

• API Gateway mendukung tiga jenis API:
  • REST API
  • HTTP API
  • WebSocket API

 

Endpoint API Gateway

• Endpoint mengatur cara klien mengakses API Anda.
• Edge-optimized: CloudFront terkelola AWS untuk latensi global rendah.
• Regional: dideploy ke AWS Region tertentu.
• Private: hanya dapat dijangkau via AWS PrivateLink.
• Endpoint privat tidak melalui internet publik.

 

REST API

• Penawaran API Gateway paling kaya fitur.
• Dibangun pada model permintaan/respons sinkron.

 

Use case REST API

 

• API perusahaan yang butuh manajemen siklus hidup penuh.
• API yang memerlukan kontrol keamanan lanjutan.
• Ekosistem pengembang pihak ketiga dengan kunci API dan rencana penggunaan.
• Integrasi layanan AWS langsung tanpa Lambda.

Dukungan REST API di API Gateway

 

• Validasi permintaan.
• Kunci API.
• Rencana penggunaan dan throttling.
• Caching respons dengan TTL yang dapat dikonfigurasi.
• Transformasi permintaan/respons via template VTL.
• Autentikasi IAM (Signature V4).
• Otorisasi Lambda, kumpulan pengguna Cognito.

Dukungan REST API di API Gateway

 

 

• Tiga jenis endpoint didukung:
  • Edge-optimized
  • Regional
  • Private
• Perlindungan eksploit web dengan AWS WAF.
• Deployment canary release.
• Observabilitas via AWS X-Ray dan logging CloudWatch.

Kompromi REST API

• Lebih mahal daripada HTTP API.
• Sedikit lebih tinggi latensinya.

 

HTTP API

• Dioptimalkan untuk kinerja dan biaya dibanding kelengkapan fitur:
  • Kinerja
  • Biaya

 

Use case HTTP API

• Beban kerja serverless dan API berbasis Lambda.
• Microservices dan API proxy ringan.
• Aplikasi sensitif latensi.
• API yang menggunakan autentikasi OAuth 2.0 / OIDC.

 

Dukungan HTTP API di API Gateway

 

• Integrasi dan authorizer Lambda proxy.
• Otorisasi JWT/OIDC native (Cognito, Auth0, Okta).
• Konfigurasi CORS bawaan di level API.
• Integrasi VPC privat via VPC Link.
• Pemetaan parameter dasar untuk header, query string, dan path.

Kompromi HTTP API

 

• HTTP API TIDAK mendukung:

  • Kunci API
  • Rencana penggunaan
  • Validasi permintaan
  • Caching respons
  • Tracing dengan AWS X-Ray

  • Transformasi payload VTL

  • Hanya mendukung:

    • Endpoint edge atau privat (hanya regional)

WebSocket API

 

• Komunikasi dua arah antara klien dan server.
• Koneksi tetap terbuka, tidak seperti REST dan HTTP API.
• Server dapat mendorong data ke klien yang tersambung.

Use case WebSocket API

• Aplikasi chat.
• Notifikasi real-time.
• Dasbor real-time.

 

Dukungan WebSocket API di API Gateway

• Transformasi data payload.
• Validasi permintaan.
• Rute bawaan khusus:
  • $connect: klien membuat koneksi
  • $disconnect: klien memutus koneksi
  • $default: tidak ada rute yang cocok

 

Caching API

• Caching respons mengurangi beban backend.
• Meningkatkan kinerja API.
• Use case umum:
  • Data yang sering diminta
  • API dengan beban baca tinggi
  • Mengurangi pemanggilan Lambda

 

Caching API

 

• Respons yang di-cache kedaluwarsa setelah TTL yang dikonfigurasi.
• Kelola data basi dengan:
  • Mengatur masa berlaku cache
  • Mengosongkan cache

Praktik terbaik desain API: penamaan resource yang jelas

 

• Path harus merepresentasikan resource, bukan aksi.
• Gunakan nomina, bukan verba.
• Baik:
  • GET /orders/123
• Hindari:
  • GET /getOrder/123

Praktik terbaik desain API: versi API

 

• Versikan API agar dapat berkembang aman seiring waktu.
• Hindari merusak klien yang sudah ada.
• Pendekatan umum:
  • Versioning di URI: GET /v1/orders
  • Parameter kueri: GET /orders?version=1
  • Header HTTP: Accept-Version: v1

Portal pengembang API

• Publikasikan dan bagikan REST API melalui portal web.
• Sediakan dokumentasi untuk konsumen API.
• Fitur utama:
  • Dokumentasi API (berkas Swagger)
  • Onboarding konsumen
  • Unduhan SDK
  • Pendaftaran kunci API dan alur langganan

 

Spesifikasi OpenAPI

• OpenAPI (Swagger): standar untuk mendeskripsikan REST API.
• API Gateway dapat mengimpor dan mengekspor spesifikasi OpenAPI.

 

Ayo berlatih!

Mengembangkan Aplikasi di AWS