Memahami API dan proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

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

Video: Tonton video singkat ini untuk mendapatkan pengantar API menggunakan {i>proxy<i}.

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 aplikasi dan data, API memungkinkan developer mengakses dan menggunakan kembali logika aplikasi yang dibangun oleh developer. Dalam kasus Web API, logika dan data tersebut diekspos melalui jaringan.

Karena aplikasi yang menggunakan API sensitif terhadap perubahan, API juga menyiratkan kontrak. Kontrak memberikan beberapa jaminan bahwa, seiring waktu, API akan berubah dalam dapat diprediksi.

Apigee memungkinkan Anda membangun API dan jika sudah memiliki API, ekspos secara langsung API tersebut. sambil menambahkan lapisan pengelolaan dan visibilitas. Jika Anda memiliki layanan dengan HTTP aktif, seperti Layanan Web berbasis SOA, layanan juga dapat diekspos sebagai API melalui Apigee.

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

Apa itu proxy API?

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

Dalam konfigurasi proxy API, ada dua jenis endpoint:

  • ProxyEndpoint: Mendefinisikan 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 memasang kebijakan di ProxyEndpoint untuk menerapkan keamanan, pemeriksaan kuota, akses kontrol dan pembatasan kapasitas.
  • TargetEndpoint: Menentukan cara proxy API berinteraksi dengan dan layanan backend. Anda mengonfigurasi TargetEndpoint untuk meneruskan permintaan ke backend yang tepat layanan IT, termasuk menentukan setelan keamanan, protokol HTTP atau HTTPS, dan koneksi tidak akurat atau tidak sesuai. Anda dapat melampirkan kebijakan ke TargetEndpoint untuk memastikan respons tersebut pesan diformat dengan benar untuk aplikasi yang membuat permintaan awal.

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

Permintaan HTTP masuk melalui titik akhir permintaan proxy, diteruskan ke titik akhir permintaan target, dan kemudian dikirim ke layanan backend. Respons HTTP masuk melalui endpoint respons target, diteruskan ke titik akhir respons {i> proxy<i}, lalu kembali ke klien.

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 mencakup minimal satu kebijakan yang dapat diperluas atau flow hook. {i>Extensible proxy<i} dapat menyertakan lebih banyak fungsionalitas daripada {i>proxy<i} standar.

Bagaimana cara membuat proxy API?

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

  • Menggunakan UI Apigee untuk menentukan proxy API dalam Antarmuka Pengguna Grafis (GUI). Untuk informasi selengkapnya, lihat Membuat Proxy API.
  • Membuat file XML, beserta file pendukung lainnya, yang mendefinisikan proxy API dan lalu mengimpornya ke Apigee.
  • Menggunakan Apigee API untuk membuat proxy API dengan membuat serangkaian REST ke Apigee.
  • Kembangkan secara lokal menggunakan Apigee di VS Code dan deploy sebagai arsip. Untuk mengetahui 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 proxy API konfigurasi saat Anda melakukan iterasi. Revisi diberi nomor urut, yang memungkinkan Anda untuk mengembalikan perubahan dengan men-deploy revisi proxy API Anda sebelumnya. Revisi memungkinkan Anda men-deploy proxy API ke lingkungan produksi sambil terus membuat revisi baru dari proxy API tersebut dalam lingkungan pengujian. Jika sudah siap, Anda dapat mempromosikan revisi API yang lebih tinggi {i>proxy<i} dari pengujian ke produksi.

Apa itu kebijakan?

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

Membuat proxy API pertama Anda

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

Pelajari lebih lanjut