Anda melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Apigee Edge memungkinkan Anda membangun RESTful API dengan mudah dan cepat yang dapat digunakan oleh developer aplikasi. Anda mengekspos API di Edge dengan membangun proxy API yang bertindak sebagai 'fasade' terkelola untuk layanan backend. Topik ini membahas hubungan antara API dan proxy API di Apigee Edge.
Video: Tonton video pendek ini untuk mengetahui pengantar tentang 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 'API Web', logika dan data tersebut diekspos melalui jaringan.
Karena aplikasi yang menggunakan API sensitif terhadap perubahan, API juga menyiratkan 'kontrak'. Kontrak ini memberikan tingkat jaminan tertentu bahwa, dari waktu ke waktu, API akan berubah dengan cara yang dapat diprediksi.
Apigee Edge memungkinkan Anda membangun API dan jika Anda sudah memiliki API, ekspos API tersebut secara langsung, sambil 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 membangun API dengan menerapkan aplikasi yang dihosting di platform Layanan API --tanpa melibatkan layanan backend. Anda dapat membangun aplikasi ini di JavaScript, Java, dan di 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.
Dalam konfigurasi proxy API, ada dua jenis endpoint:
- ProxyEndpoint: Menentukan cara aplikasi klien menggunakan API Anda. Anda mengonfigurasi ProxyEndpoint untuk menentukan URL proxy API. Endpoint proxy juga menentukan apakah aplikasi mengakses proxy API melalui HTTP atau HTTPS. Biasanya, Anda 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 pesan respons diformat dengan benar untuk aplikasi yang membuat permintaan awal.
Anda dapat memvisualisasikan proxy API seperti yang ditunjukkan oleh grafik di bawah:
Bagaimana cara membuat proxy API?
Proxy API terdiri dari paket file konfigurasi XML dan kode (seperti JavaScript dan Java). Apigee menyediakan beberapa cara untuk membuat proxy API, termasuk:
- Menggunakan UI pengelolaan Edge 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 Edge.
- Menggunakan API pengelolaan Edge 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 dengan menggunakan kebijakan. Kebijakan seperti modul yang menerapkan fungsi pengelolaan tertentu yang terbatas 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 keamanan, pembatasan kapasitas, transformasi, dan kemampuan mediasi, sehingga Anda tidak perlu membuat kode dan mempertahankan fungsi ini sendiri.
Membuat proxy API pertama
Apigee menyediakan serangkaian tutorial yang dapat Anda gunakan untuk membuat API pertama. Mulai dengan Membangun proxy API pertama.
Cara terbaik untuk mempelajari proxy API adalah dengan menggunakan sampel seperti yang dijelaskan dalam Menggunakan proxy API contoh.