Memahami API dan proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Apigee memungkinkan Anda membuat RESTful API dengan mudah dan cepat yang dapat digunakan oleh developer aplikasi. Anda mengekspos API di Apigee dengan membuat proxy API yang berfungsi sebagai 'facade' terkelola untuk layanan backend. Topik ini membahas hubungan antara API dan proxy API di Apigee.

Video: Tonton video singkat ini untuk mengetahui pengantar proxy API.

Apa yang dimaksud dengan API?

API adalah antarmuka yang memudahkan satu aplikasi untuk menggunakan kemampuan atau data dari aplikasi lain. Dengan menentukan titik entri yang stabil dan disederhanakan ke logika dan data aplikasi, API memungkinkan developer mengakses dan menggunakan kembali logika aplikasi yang dibuat oleh developer lain dengan mudah. Dalam kasus Web API, logika dan data tersebut diekspos melalui jaringan.

Karena aplikasi yang menggunakan API sensitif terhadap perubahan, API juga menyiratkan kontrak. Kontrak ini memberikan tingkat kepastian tertentu bahwa, seiring waktu, API akan berubah dengan cara yang dapat diprediksi.

Apigee memungkinkan Anda mem-build API dan jika sudah memiliki API, mengeksposnya secara langsung, sekaligus menambahkan lapisan pengelolaan dan visibilitas. Jika Anda memiliki layanan yang mengaktifkan HTTP, seperti layanan Web berbasis SOA, layanan tersebut juga dapat diekspos sebagai API melalui Apigee.

Apigee juga memungkinkan Anda mem-build API dengan menerapkan aplikasi yang dihosting di platform API Services, tanpa melibatkan layanan backend. Anda dapat mem-build aplikasi ini dalam JavaScript dan Java.

Apa yang dimaksud dengan proxy API?

Anda mengekspos API di Apigee dengan menerapkan proxy API. Proxy API memisahkan API yang ditampilkan ke aplikasi dari layanan backend Anda, sehingga melindungi aplikasi tersebut dari perubahan kode backend. Saat Anda membuat perubahan backend pada layanan, aplikasi akan terus memanggil API yang sama tanpa gangguan apa pun.

Dalam konfigurasi proxy API, ada dua jenis endpoint:

  • ProxyEndpoint: Menentukan cara aplikasi klien menggunakan API Anda. Anda mengonfigurasi ProxyEndpoint untuk menentukan URL proxy API Anda. Endpoint proxy juga menentukan apakah aplikasi mengakses proxy API melalui HTTP atau HTTPS. Anda biasanya melampirkan policies ke ProxyEndpoint untuk menerapkan keamanan, pemeriksaan kuota, dan jenis kontrol akses dan pembatasan kapasitas lainnya.
  • TargetEndpoint: Menentukan cara proxy API berinteraksi dengan layanan backend Anda. Anda mengonfigurasi TargetEndpoint untuk meneruskan permintaan ke layanan backend yang tepat, termasuk menentukan setelan keamanan, protokol HTTP atau HTTPS, dan informasi koneksi lainnya. Anda dapat melampirkan policies ke TargetEndpoint untuk memastikan bahwa pesan respons diformat dengan benar untuk aplikasi yang membuat permintaan awal.

Anda dapat memvisualisasikan proxy API seperti yang ditunjukkan oleh gambar di bawah:

Permintaan HTTP masuk melalui endpoint permintaan proxy, diteruskan ke endpoint permintaan target, lalu dikirim ke layanan backend. Respons HTTP masuk melalui endpoint respons target, diteruskan ke endpoint respons proxy, lalu kembali ke klien.

Jenis proxy API

Apigee mendukung dua jenis proxy:

  • Proxy standar hanya menyertakan kebijakan standar. Proxy standar cocok untuk solusi API ringan dan tidak dapat disertakan dalam produk API.
  • Proxy yang dapat diperluas menyertakan setidaknya satu hook kebijakan yang dapat diperluas atau flow. Proksi yang dapat diperluas dapat menyertakan lebih banyak fungsi daripada proksi standar.

Bagaimana cara membuat proxy API?

Proxy API terdiri dari paket file dan kode konfigurasi XML (seperti JavaScript dan Java). Apigee menyediakan beberapa cara bagi Anda untuk membuat proxy API, termasuk:

  • Menggunakan UI Apigee untuk menentukan proxy API di Antarmuka Pengguna Grafis (GUI). Untuk mengetahui informasi selengkapnya, lihat Mem-build proxy API sederhana.
  • Membuat file XML, beserta file pendukung lainnya, yang menentukan proxy API Anda, lalu mengimpornya ke Apigee.
  • Menggunakan Apigee API untuk membuat proxy API dengan membuat serangkaian permintaan REST ke Apigee.
  • Mengembangkan secara lokal menggunakan Apigee di VS Code dan men-deploy sebagai arsip. Untuk informasi selengkapnya, lihat Ringkasan pengembangan lokal dengan Apigee

Apa yang dimaksud dengan revisi proxy API?

Revisi proxy API menyediakan mekanisme ringan untuk mengelola update pada konfigurasi proxy API saat Anda melakukan iterasi. Revisi diberi nomor secara berurutan, sehingga Anda dapat mengembalikan perubahan dengan men-deploy revisi proxy API sebelumnya. Dengan revisi, Anda dapat men-deploy proxy API ke lingkungan produksi sambil terus membuat revisi baru proxy API tersebut di lingkungan pengujian. Jika sudah siap, Anda dapat mempromosikan revisi proxy API yang lebih tinggi dari pengujian ke produksi.

Apa yang dimaksud dengan kebijakan?

Apigee memungkinkan Anda mengontrol perilaku API tanpa menulis kode apa pun menggunakan policies. Kebijakan seperti modul yang menerapkan fungsi pengelolaan tertentu dan terbatas sebagai bagian dari alur permintaan/respons proxy. Kebijakan dirancang agar Anda dapat menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal. Kebijakan menyediakan fitur seperti keamanan, pembatasan kapasitas, transformasi, dan mediasi, sehingga Anda tidak perlu membuat kode dan mengelola fungsi ini sendiri.

Membuat proxy API pertama Anda

Apigee menyediakan serangkaian tutorial yang dapat Anda gunakan untuk membuat API pertama. Mulai dengan artikel Membangun proxy API pertama Anda. Lihat juga Topik memulai lainnya.

Pelajari lebih lanjut