Pilih jenis integrasi API Gateway API

Anda memilih jenis integrasi API sesuai dengan jenis titik akhir integrasi yang bekerja dengan Anda dan bagaimana Anda ingin data diteruskan ke dan dari titik akhir integrasi. Untuk fungsi Lambda, Anda dapat memiliki integrasi proxy Lambda, atau integrasi kustom Lambda. Untuk titik akhir HTTP, Anda dapat memiliki integrasi proxy HTTP atau integrasi kustom HTTP. Untuk tindakan AWS layanan, Anda memiliki AWS integrasi tipe non-proxy saja. API Gateway juga mendukung integrasi tiruan, di mana API Gateway berfungsi sebagai titik akhir integrasi untuk menanggapi permintaan metode.

Integrasi kustom Lambda adalah kasus khusus AWS integrasi, di mana titik akhir integrasi sesuai dengan tindakan pemanggilan fungsi layanan Lambda.

Secara terprogram, Anda memilih jenis integrasi dengan mengatur typeproperti pada sumber daya. Integration Untuk integrasi proxy Lambda, nilainya adalah. AWS_PROXY Untuk integrasi kustom Lambda dan semua AWS integrasi lainnya, memang demikian. AWS Untuk integrasi proxy HTTP dan integrasi HTTP, nilainya adalah HTTP_PROXY danHTTP, masing-masing. Untuk integrasi tiruan, type nilainya adalahMOCK.

Integrasi proxy Lambda mendukung pengaturan integrasi yang efisien dengan satu fungsi Lambda. Pengaturannya sederhana dan dapat berkembang dengan backend tanpa harus meruntuhkan pengaturan yang ada. Untuk alasan ini, sangat disarankan untuk integrasi dengan fungsi Lambda.

Sebaliknya, integrasi kustom Lambda memungkinkan penggunaan kembali template pemetaan yang dikonfigurasi untuk berbagai titik akhir integrasi yang memiliki persyaratan serupa dari format data input dan output. Pengaturan lebih terlibat dan direkomendasikan untuk skenario aplikasi yang lebih maju.

Demikian pula, integrasi proxy HTTP memiliki pengaturan integrasi yang efisien dan dapat berkembang dengan backend tanpa harus meruntuhkan pengaturan yang ada. Integrasi kustom HTTP lebih terlibat untuk disiapkan, tetapi memungkinkan penggunaan kembali template pemetaan yang dikonfigurasi untuk titik akhir integrasi lainnya.

Daftar berikut merangkum jenis integrasi yang didukung:

• AWS: Jenis integrasi ini memungkinkan API mengekspos tindakan AWS layanan. Dalam AWS integrasi, Anda harus mengonfigurasi permintaan integrasi dan respons integrasi dan menyiapkan pemetaan data yang diperlukan dari permintaan metode ke permintaan integrasi, dan dari respons integrasi ke respons metode.

• AWS_PROXY: Jenis integrasi ini memungkinkan metode API diintegrasikan dengan tindakan pemanggilan fungsi Lambda dengan pengaturan integrasi yang fleksibel, serbaguna, dan efisien. Integrasi ini bergantung pada interaksi langsung antara klien dan fungsi Lambda terintegrasi.

  Dengan jenis integrasi ini, juga dikenal sebagai integrasi proxy Lambda, Anda tidak mengatur permintaan integrasi atau respons integrasi. API Gateway meneruskan permintaan masuk dari klien sebagai input ke fungsi Lambda backend. Fungsi Lambda terintegrasi mengambil input format ini dan mem-parsing input dari semua sumber yang tersedia, termasuk header permintaan, variabel jalur URL, parameter string kueri, dan isi yang berlaku. Fungsi mengembalikan hasil mengikuti format output ini.

  Ini adalah jenis integrasi yang disukai untuk memanggil fungsi Lambda melalui API Gateway dan tidak berlaku untuk tindakan AWS layanan lainnya, termasuk tindakan Lambda selain tindakan pemanggilan fungsi.

• HTTP: Jenis integrasi ini memungkinkan API mengekspos titik akhir HTTP di backend. Dengan HTTP integrasi, juga dikenal sebagai integrasi kustom HTTP, Anda harus mengonfigurasi permintaan integrasi dan respons integrasi. Anda harus menyiapkan pemetaan data yang diperlukan dari permintaan metode ke permintaan integrasi, dan dari respons integrasi ke respons metode.

• HTTP_PROXY: Integrasi proxy HTTP memungkinkan klien untuk mengakses titik akhir HTTP backend dengan pengaturan integrasi yang disederhanakan pada metode API tunggal. Anda tidak mengatur permintaan integrasi atau respons integrasi. API Gateway meneruskan permintaan masuk dari klien ke titik akhir HTTP dan meneruskan respons keluar dari titik akhir HTTP ke klien.

• MOCK: Jenis integrasi ini memungkinkan API Gateway mengembalikan respons tanpa mengirim permintaan lebih lanjut ke backend. Ini berguna untuk pengujian API karena dapat digunakan untuk menguji pengaturan integrasi tanpa menimbulkan biaya untuk menggunakan backend dan untuk mengaktifkan pengembangan kolaboratif API.

  Dalam pengembangan kolaboratif, tim dapat mengisolasi upaya pengembangan mereka dengan menyiapkan simulasi komponen API yang dimiliki oleh tim lain dengan menggunakan integrasi. MOCK Ini juga digunakan untuk mengembalikan header terkait CORS untuk memastikan bahwa metode API mengizinkan akses CORS. Faktanya, konsol API Gateway mengintegrasikan OPTIONS metode untuk mendukung CORS dengan integrasi tiruan. Respons gateway adalah contoh lain dari integrasi tiruan.