Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Apigee Edge memungkinkan Anda mem-build RESTful API dengan mudah dan cepat yang dapat digunakan oleh developer aplikasi. Anda mengekspos API di Edge dengan membuat proxy API yang berfungsi sebagai 'facade' terkelola untuk layanan backend. Topik ini membahas hubungan antara API dan proxy API di Apigee Edge.
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 ditampilkan melalui jaringan.
Karena aplikasi yang menggunakan API sensitif terhadap perubahan, API juga menyiratkan 'kontrak'. Kontrak memberikan tingkat kepastian tertentu bahwa, seiring waktu, API akan berubah dengan cara yang dapat diprediksi.
Apigee Edge 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 Edge.
Edge juga memungkinkan Anda mem-build API dengan menerapkan aplikasi yang dihosting di platform Layanan API, tanpa melibatkan layanan backend. Anda dapat mem-build aplikasi ini di JavaScript, Java, dan Node.js.
Apa yang dimaksud dengan proxy API?
Anda mengekspos API di Apigee Edge 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 melakukan 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:
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 pengelolaan Edge 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 Edge.
- Menggunakan Edge management API untuk membuat proxy API dengan membuat serangkaian permintaan REST ke Edge.
- Men-deploy aplikasi Node.js sebagai proxy. Lihat Men-deploy aplikasi Node.js mandiri.
Apa itu kebijakan?
Edge 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.
Cara terbaik untuk mempelajari proxy API adalah dengan menggunakan contoh seperti yang dijelaskan dalam Menggunakan contoh proxy API.