Apa itu Apigee Edge?

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Apigee Edge adalah platform untuk mengembangkan dan mengelola API. Dengan layanan fronting menggunakan lapisan proxy, Edge menyediakan abstraksi atau facade untuk API layanan backend Anda dan menyediakan keamanan, pembatasan kapasitas, kuota, analisis, dan lainnya.

Misalnya, Anda dapat melihat webcast tentang cara Walgreens menggunakan API dan Apigee Edge untuk menyediakan ekosistem aplikasi yang kaya seputar pencetakan foto, resep, dan layanan lain yang mereka sediakan.

Buat proxy pertama Anda.

Akselerasi digital

Memilih antara pengelolaan layanan dan pengelolaan API

Menyediakan layanan Anda di web

Perusahaan saat ini ingin menyediakan layanan backend mereka di web sehingga layanan ini dapat digunakan oleh aplikasi yang berjalan di perangkat seluler dan desktop. Perusahaan mungkin ingin mengekspos layanan yang menyediakan informasi harga dan ketersediaan produk, layanan penjualan dan pemesanan, layanan pelacakan pesanan, dan layanan lain yang diperlukan oleh aplikasi klien.

Perusahaan sering mengekspos layanan sebagai kumpulan endpoint HTTP. Developer aplikasi klien kemudian membuat permintaan HTTP ke endpoint ini. Bergantung pada endpoint, layanan tersebut kemudian dapat menampilkan data, yang diformat sebagai XML atau JSON, kembali ke aplikasi klien.

Aplikasi klien yang menggunakan layanan ini dapat diimplementasikan sebagai aplikasi mandiri untuk perangkat seluler atau tablet, sebagai aplikasi HTML5 yang berjalan di browser, atau sebagai jenis aplikasi lain yang dapat membuat permintaan ke endpoint HTTP dan menggunakan data respons apa pun. Aplikasi ini dapat dikembangkan dan dirilis oleh perusahaan yang sama yang mengekspos layanan, atau oleh developer aplikasi pihak ketiga yang menggunakan layanan yang tersedia secara publik.

Gambar berikut menunjukkan jenis model ini:

Karena penyedia menyediakan layanan mereka melalui web, mereka harus memastikan bahwa mereka telah mengambil semua langkah yang diperlukan untuk mengamankan dan melindungi layanan mereka dari akses yang tidak sah. Sebagai penyedia layanan, pertimbangkan:

• Keamanan: Bagaimana Anda akan mengontrol akses ke layanan Anda untuk mencegah akses yang tidak sah?
• Kompatibilitas: Apakah layanan Anda akan berfungsi di berbagai platform dan perangkat?
• Kemampuan pengukuran: Bagaimana Anda dapat memantau layanan untuk memastikan layanan tersebut tersedia?
• Monetisasi: Bagaimana Anda dapat melacak dan menagih pelanggan untuk akses ke layanan Anda ?
• Dan banyak pertimbangan lainnya

Setelah aplikasi klien dirilis yang mengakses layanan apa pun, penyedia layanan kemudian diwajibkan untuk memastikan bahwa layanan tersebut terus berfungsi dari waktu ke waktu saat mereka menambahkan, mengubah, atau menghapus layanan tersebut. Penyedia layanan juga harus memiliki cara untuk memberi tahu developer aplikasi tentang perubahan apa pun pada layanan untuk memastikan aplikasi klien tetap sinkron dengan layanan tersebut.

Developer aplikasi klien menghadapi tantangan saat mencoba menggunakan layanan dari penyedia yang berbeda. Ada banyak teknologi yang tersedia saat ini untuk digunakan oleh penyedia layanan untuk mengekspos layanannya. Aplikasi klien yang sama mungkin harus menggunakan satu mekanisme untuk menggunakan layanan dari satu penyedia, dan mekanisme yang berbeda untuk menggunakan layanan dari penyedia yang berbeda. Developer aplikasi bahkan dapat menghadapi situasi di mana mereka harus menggunakan mekanisme yang berbeda untuk menggunakan layanan dari penyedia yang sama.

Menyediakan layanan melalui Apigee Edge

Apigee Edge memungkinkan Anda memberikan akses yang aman ke layanan Anda dengan API yang ditentukan dengan baik dan konsisten di seluruh layanan Anda, terlepas dari implementasi layanan. API yang konsisten:

• Memudahkan developer aplikasi untuk menggunakan layanan Anda.
• Memungkinkan Anda mengubah implementasi layanan backend tanpa memengaruhi API publik API.
• Memungkinkan Anda memanfaatkan analisis, monetisasi, portal developer, dan fitur lainnya yang terintegrasi ke dalam Edge.

Gambar berikut menunjukkan arsitektur dengan Edge yang menangani permintaan dari aplikasi klien ke layanan backend Anda:

Daripada membuat developer aplikasi menggunakan layanan Anda secara langsung, mereka mengakses proxy API yang dibuat di Edge. Fungsi proxy API sebagai pemetaan endpoint HTTP yang tersedia secara publik ke layanan backend Anda. Dengan membuat proxy API, Anda mengizinkan Edge menangani tugas keamanan dan otorisasi yang diperlukan untuk melindungi layanan Anda, serta menganalisis, memantau, dan memonetisasi layanan tersebut.

Karena developer aplikasi membuat permintaan HTTP ke proxy API, bukan langsung ke layanan Anda, developer tidak perlu mengetahui apa pun tentang implementasi layanan Anda. Yang perlu diketahui developer adalah:

• URL endpoint proxy API.
• Parameter kueri, header, atau parameter isi yang diteruskan dalam permintaan.
• Kredensial autentikasi dan otorisasi yang diperlukan.
• Format respons, termasuk format data respons, seperti XML atau JSON.

Proxy API mengisolasi developer aplikasi dari layanan backend Anda. Oleh karena itu, Anda bebas mengubah implementasi layanan selama API publik tetap konsisten. Dengan mempertahankan API frontend yang konsisten, aplikasi klien yang ada akan terus berfungsi terlepas dari perubahan di backend.

Anda dapat menggunakan kebijakan pada proxy API untuk menambahkan fungsi ke layanan tanpa harus melakukan perubahan apa pun pada layanan backend. Misalnya, Anda dapat menambahkan kebijakan ke proxy untuk melakukan transformasi dan pemfilteran data, menambahkan keamanan, menjalankan logika kondisional atau kode kustom, dan melakukan banyak tindakan lainnya. Hal penting yang perlu diingat adalah Anda menerapkan kebijakan di Edge, bukan di server backend.

Untuk mengetahui informasi selengkapnya, lihat Memahami API dan proxy API.

Membuat produk API

Proxy API adalah endpoint HTTP di Apigee Edge yang digunakan developer untuk mengakses layanan backend Anda. Meskipun memungkinkan, Anda biasanya tidak menyediakan proxy API individual. Sebagai gantinya, Anda mengelompokkan satu atau beberapa proxy API ke dalam produk API.

Produk API adalah paket proxy API yang digabungkan dengan paket layanan. Paket layanan tersebut dapat menetapkan batas akses pada proxy API, memberikan keamanan, memungkinkan pemantauan dan analisis, serta menyediakan fitur tambahan. Produk API juga merupakan mekanisme pusat yang digunakan Edge untuk otorisasi dan kontrol akses ke API Anda.

Anda memiliki banyak fleksibilitas saat membuat produk API. Misalnya, beberapa produk API dapat menggunakan proxy API yang sama. Gambar berikut menunjukkan tiga produk API. Perhatikan bahwa semua produk mengizinkan akses ke proxy API 3, tetapi hanya produk A yang mengizinkan akses ke proxy API 1.

Anda dapat menetapkan properti yang berbeda pada setiap produk API. Misalnya, Anda dapat menyediakan satu produk API dengan batas akses rendah, seperti 1.000 permintaan per hari, dengan harga murah. Kemudian, Anda merilis produk API lain yang menyediakan akses ke proxy API yang sama, tetapi dengan batas akses yang jauh lebih tinggi, dengan harga yang lebih tinggi. Atau, Anda dapat membuat produk API gratis yang memungkinkan akses hanya baca ke layanan Anda, lalu menjual produk API ke proxy API yang sama yang memungkinkan akses baca/tulis.

Untuk mengetahui informasi selengkapnya, lihat Mengelola produk API.

Mengizinkan aplikasi sisi klien mengakses produk API Anda

Saat developer aplikasi memutuskan bahwa mereka ingin mengakses layanan Anda, mereka harus terlebih dahulu mendaftarkan aplikasi klien mereka ke produk API Anda.

Setelah pendaftaran, developer aplikasi akan menerima kunci API yang kemudian harus mereka sertakan dalam setiap permintaan ke proxy API yang disertakan dalam produk API. Kunci tersebut diautentikasi dan, jika autentikasi berhasil, permintaan diizinkan untuk mengakses layanan backend Anda.

Kapan saja, Anda dapat mencabut kunci sehingga aplikasi klien tidak lagi memiliki akses ke layanan Anda. Atau, Anda dapat menentukan batas waktu pada kunci sehingga developer harus memperbarui kunci setelah waktu tertentu.

Anda memutuskan cara menangani permintaan pendaftaran dari developer untuk mengakses produk API Anda. Dengan menggunakan Layanan Developer Apigee Edge, Anda dapat mengotomatiskan proses pendaftaran; atau Anda dapat menggunakan proses manual untuk mengontrol akses.

Membuat produk API dan menyediakannya untuk developer

1. Buat satu atau beberapa proxy API yang memetakan URL yang tersedia secara publik ke layanan backend Anda.
2. Buat produk API yang memaketkan proxy API Anda.
3. Deploy proxy API dan produk API Anda.
4. Beri tahu developer bahwa produk API tersedia.

Setelah mengetahui ketersediaan produk API Anda, developer aplikasi:

1. Mendaftarkan aplikasi klien mereka ke produk API Anda.
2. Menerima kunci API untuk produk API.
3. Membuat permintaan ke layanan Anda melalui proxy API (yang dipaketkan dalam produk API) dan meneruskan kunci API dengan setiap permintaan.

Komponen Apigee Edge

Apigee Edge terdiri dari runtime API, pemantauan dan analisis, serta layanan developer yang bersama-sama menyediakan infrastruktur komprehensif untuk pembuatan, keamanan, pengelolaan, dan operasi API.

Gambar berikut menunjukkan layanan Edge:

Runtime API Edge

Layanan API Apigee Edge adalah tentang pembuatan dan penggunaan API, baik Anda membuat proxy API sebagai penyedia layanan atau menggunakan API, SDK, dan layanan praktis lainnya sebagai developer aplikasi.

Server pengelolaan API menyediakan alat untuk menambahkan dan mengonfigurasi proxy API, menyiapkan produk API, serta mengelola developer aplikasi dan aplikasi klien. Server ini memindahkan banyak masalah pengelolaan umum dari layanan backend Anda. Saat menambahkan proxy API, Anda dapat menerapkan kebijakan ke proxy API untuk menambahkan keamanan, pembatasan kapasitas, mediasi, caching, dan sebagainya. Anda juga dapat menyesuaikan perilaku proxy API dengan menerapkan skrip kustom, melakukan panggilan ke API dan layanan pihak ketiga, dan sebagainya. Lihat Memahami API dan proxy API untuk mengetahui informasi selengkapnya.

Jika Anda adalah developer Node.js, Anda dapat dengan mudah menambahkan modul Node.js ke Edge untuk membuat API dan mashup API, sekaligus memanfaatkan manfaat yang disediakan Edge, mulai dari transformasi pesan hingga keamanan hingga analisis.

Pemantauan &analisis Edge

Analisis API Apigee Edge menyediakan alat yang canggih untuk melihat tren penggunaan API Anda dalam jangka pendek dan panjang. Anda dapat mensegmentasikan audiens berdasarkan developer dan aplikasi teratas, memahami penggunaan berdasarkan metode API untuk mengetahui tempat berinvestasi, dan membuat laporan kustom tentang informasi tingkat bisnis atau operasional.

Saat data melewati Edge, beberapa jenis informasi default dikumpulkan, termasuk URL, IP, ID pengguna untuk informasi panggilan API, latensi, data error, dan sebagainya. Anda dapat membuat kebijakan untuk menambahkan informasi lain, seperti header, parameter kueri, dan bagian permintaan atau respons yang diekstrak dari XML atau JSON. Informasi ini dikumpulkan secara asinkron dari alur permintaan/respons yang sebenarnya dan oleh karena itu tidak memengaruhi performa API.

UI pengelolaan memungkinkan Anda melihat beberapa metrik dan dimensi di browser, seperti yang ditunjukkan pada gambar berikut:

Namun, Anda juga dapat mengakses dan mengontrol Layanan Analisis dengan antarmuka command line atau melalui RESTful API. Lihat Ringkasan Analisis API untuk mengetahui informasi selengkapnya.

Ekosistem developer Edge

Apigee Edge menyediakan layanan developer yang memungkinkan Anda:

• Mengelola komunitas developer aplikasi yang menggunakan layanan Anda.
• Bekerja sama dengan developer internal dan eksternal serta memformalkan hubungan dengan model keuangan.
• Mengaktifkan developer dan membuat portal developer. Developer aplikasi terhubung ke portal Anda untuk mengakses dokumentasi API guna mempelajari lebih lanjut produk API yang tersedia secara publik dan mengelola kunci API.

Setiap pelanggan Edge dapat membuat portal developer mereka sendiri, baik di cloud maupun di lokal dengan Apigee Edge untuk Private Cloud.

Apigee Edge memungkinkan Anda membuat dua jenis portal:

• Portal terintegrasi yang dapat disediakan secara instan. Lihat Membuat portal terintegrasi.

  

• Portal berbasis Drupal. Lihat Membuat portal berbasis Drupal.

  

Monetisasi

Kemampuan monetisasi menyediakan infrastruktur dan hubungan keuangan untuk mengubah komunitas Developer Anda menjadi saluran yang sebenarnya untuk aset digital Anda. Dengan monetisasi, Anda dapat membuat berbagai paket tarif yang menagih biaya kepada developer untuk penggunaan produk API Anda atau memungkinkan Anda membayar developer dalam skenario bagi hasil.

Paket ini mencakup paket prabayar, paket pascabayar, paket biaya tetap, paket tarif variabel, paket "freemium", paket yang disesuaikan untuk developer tertentu, paket yang mencakup grup developer, dan lainnya. Selain itu, monetisasi mencakup fasilitas pelaporan dan penagihan.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan monetisasi.

Jenis Edge

Apigee Edge hadir dalam jenis berikut:

• Cloud Publik: Versi SAAS yang dihosting dan Apigee mempertahankan lingkungan, sehingga Anda dapat berkonsentrasi pada pembuatan layanan dan menentukan API untuk layanan tersebut.
• Cloud Pribadi: Instalasi lokal tempat Anda mengontrol lingkungan hardware dan bertanggung jawab atas instalasi, upgrade, pemeliharaan, dan proses administratif lainnya.

Jika Anda tertarik dengan versi Apigee hybrid kami, lihat topik Apigee X berikut:

• Jenis Apigee
• Apa itu Apigee Hybrid?

Secara fungsional, versi Cloud Publik dan Cloud Pribadi sangat mirip. Namun, versi Cloud Pribadi tidak mendukung semua fitur versi Cloud Publik. Fitur yang tidak didukung oleh Cloud Pribadi meliputi:

• Target yang dihosting
• Ekstensi
• Portal developer terintegrasi (Catatan: Portal developer berbasis Drupal didukung)
• Pemantauan API
• Sense

Untuk mengetahui daftar perbedaan di antara jenis, lihat Membandingkan produk Apigee.

Ada juga perbedaan kecil antara API, seperti yang dijelaskan dalam Perbedaan antara Edge untuk API Cloud Publik dan API Cloud Pribadi.

Cloud Publik mendukung akun gratis dan berbayar. Cloud Pribadi memerlukan akun berbayar.

Untuk mendukung instalasi lokal sepenuhnya, versi Cloud Pribadi mencakup komponen seperti server pengelolaan Apigee, database Apache Cassandra NoSQL, server OpenLDAP, Router pesan, dan Pemroses Pesan.