Memahami API dan proxy API

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

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

Video: Tonton video singkat ini untuk pengenalan 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 dibangun oleh developer lain dengan mudah. Pada 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 jaminan bahwa, seiring waktu, API akan berubah dengan cara yang dapat diprediksi.

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

Apigee juga memungkinkan Anda membangun API dengan mengimplementasikan aplikasi yang dihosting di platform Layanan API—tanpa melibatkan layanan backend. Anda dapat membangun aplikasi ini di JavaScript dan Java.

Apa itu proxy API?

Anda mengekspos API di Apigee dengan mengimplementasikan 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 Anda, aplikasi 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 akan mengonfigurasi ProxyEndpoint untuk menentukan URL proxy API Anda. Endpoint proxy juga menentukan apakah aplikasi mengakses proxy API melalui HTTP atau HTTPS. Anda biasanya melampirkan kebijakan ke ProxyEndpoint untuk menerapkan keamanan, pemeriksaan kuota, dan jenis kontrol akses serta 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 kebijakan 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 grafik di bawah ini:

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

Jenis proxy API berlaku untuk paket Pay-as-you-go dan Subscription 2024. Pengguna yang berlangganan pada paket Subscription 2021 tidak akan melihat jenis proxy API di UI Apigee dan tidak perlu mengetahui jenis proxy API.

Apigee mendukung dua jenis proxy:

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

Bagaimana cara membuat proxy API?

Proxy API terdiri dari paket kode dan file 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 Membangun 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.
  • Kembangkan secara lokal menggunakan Apigee di VS Code dan deploy sebagai arsip. Untuk informasi selengkapnya, lihat Ringkasan pengembangan lokal dengan Apigee

Apa yang dimaksud dengan revisi proxy API?

Revisi proxy API memberikan mekanisme ringan untuk mengelola update pada konfigurasi proxy API saat Anda melakukan iterasi. Revisi diberi nomor urut, 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 terhadap 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 perlu menulis kode apa pun dengan menggunakan kebijakan. Kebijakan itu seperti modul yang menerapkan fungsi pengelolaan terbatas tertentu sebagai bagian dari alur permintaan/respons proxy. Kebijakan dirancang untuk memungkinkan Anda menambahkan jenis kemampuan pengelolaan umum ke API dengan mudah dan andal. Kebijakan menyediakan fitur seperti kemampuan keamanan, pembatasan kapasitas, transformasi, dan mediasi, sehingga Anda tidak perlu membuat kode dan memelihara fungsi ini sendiri.

Membuat proxy API pertama Anda

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

Pelajari lebih lanjut