Memanfaatkan Apigee untuk mengurangi beban developer

Aplikasi yang bagus bersifat cermat dan konsisten dalam pengiriman barang dan layanannya. Aplikasi ini membuat operasinya terasa ringan, lancar, dan menyenangkan untuk digunakan. Tujuan akhirnya harus selalu memberikan pengalaman yang luar biasa kepada pengguna, dan organisasi yang membangun produk yang sukses selalu memulai dari "luar ke dalam", terutama dengan tetap berfokus pada pengguna. Memberikan pengalaman luar biasa dapat dicapai dengan mendukung developer untuk membuat aplikasi yang menginspirasi, dan untuk mencapainya, penting untuk menyediakan API yang efektif bagi developer. API yang efektif menghilangkan kompleksitas organisasi sehingga developer dapat berfokus pada upaya membangun pengalaman pengguna. Namun, API yang efektif tidak muncul begitu saja. Organisasi ini juga memperlakukan API mereka seperti produk digital, yang mengkhususkan seluruh tim untuk pembuatan dan pengelolaan mereka sebagai fitur utama dari platform mereka. 

Platform yang digunakan developer untuk membuat produk digital juga harus diperlakukan sebagai produk. Dengan demikian, tim engineering platform juga harus mengambil pendekatan dari luar ke dalam kepada penggunanya—para developer—untuk memahami kebutuhan mereka dan menciptakan pengalaman yang menyenangkan bagi mereka. Sebagai engineer platform, Anda bertanggung jawab untuk membuat, membangun, dan menyatukan template dan alat internal yang akan dimanfaatkan developer Anda saat membangun software, baik saat mereka mengembangkan aplikasi frontend, layanan backend, maupun memproduksi dan menggunakan API. Peran tim Anda adalah menetapkan bagaimana software yang dibuat organisasi Anda harus diuji, dilindungi, di-deploy, dan dikelola. Mengurai silo memungkinkan pembuatan API yang lebih baik.

Sama seperti aspek pengembangan software lainnya, tim Anda sebaiknya mencegah developer membuat ulang elemen arsitektur API satu per satu yang memiliki masalah lintas sektor. Sebagai gantinya, tawarkan serangkaian alat sederhana dan opsi konfigurasi yang dapat langsung mereka manfaatkan. Beberapa aspek pengelolaan API yang paling baik ditangani oleh platform Anda termasuk (tetapi tidak terbatas pada) berikut ini: 

• Alat untuk membagikan standar dan membuat API yang konsisten
• Memberikan panduan desain dan penskoran API berdasarkan praktik terbaik
• Katalog dan mekanisme penemuan
• Kontrol keamanan dan akses
• Protokol autentikasi dan otorisasi
• Mekanisme pencegahan penyalahgunaan
• Fitur pengelolaan traffic
• Kuota penggunaan dan throttling 
• Perutean dinamis untuk permintaan
• Alat visibilitas dan pemantauan
• Pelacakan dan proses debug
• Analisis penggunaan dan performa
• Proses deployment otomatis
• Ketersediaan tinggi, dan penskalaan untuk peningkatan permintaan

Apigee adalah platform pengelolaan API yang memberi tim platform dan pelanggan internal mereka serangkaian kemampuan untuk membangun, mengatur, dan mengoperasikan API secara lebih efektif:

Apigee membantu produsen API membangun dan mengelola API yang mengekspos logika bisnis mereka dengan menyediakan lapisan keamanan tambahan, penemuan, dan kemampuan observasi bagi developer. Tim produk dapat menggabungkan dan memublikasikan API mereka sebagai kumpulan “produk” yang fleksibel, dengan berbagai perilaku konsumsi. Apigee juga membantu konsumen API untuk dengan mudah mempelajari produk API yang tersedia, menjelajahi dokumentasi, dan langsung bekerja untuk mulai mengembangkan aplikasi dengan hambatan minimal. Kini, dengan bantuan AI generatif, Apigee juga mengubah cara pengembangan API sehingga memudahkan developer berpengalaman dan baru untuk mengelola komunikasi antara sistem dengan lancar.

Proses pengelolaan API di Apigee dimulai dengan membuat proxy API. Proxy API mengekspos antarmuka yang digunakan developer untuk mengakses layanan backend. Bukannya menggunakan layanan tersebut secara langsung, layanan tersebut justru mengakses proxy Apigee API yang dibuat produsen. Dengan proxy, Anda dapat memisahkan backend dari API sebenarnya sehingga memberikan pengalaman yang lebih andal kepada pelanggan. Hal ini memungkinkan Anda untuk memperbarui dan membuat perubahan pada backend tanpa memengaruhi pelanggan Anda. Tim API dapat memanfaatkan kemampuan yang disediakan oleh proxy untuk mengamankan dan mengontrol perilaku API mereka. Agar program API berhasil diskalakan seiring bertambahnya jumlah tim produksi dan pengguna, platform harus mengaktifkan jalur ideal melalui pipeline otomatisasi yang lancar, dan fungsi yang dapat digunakan kembali.

Misalnya perusahaan Anda ingin membuat API baru yang dapat dimonetisasi untuk memperoleh pendapatan tambahan. Tim Anda bertemu dengan developer untuk menyusun strategi yang komprehensif tentang cara membuat API baru ini. Tugas tim Anda sekarang adalah memenuhi persyaratan tersebut dan menstandarkannya dalam bentuk template API yang pasti dan berisi kebijakan umum, kontrol perutean traffic, dan konvensi penanganan error. Bergantung pada kasus penggunaan, mungkin ada kumpulan template untuk mencakup setiap kasus penggunaan. Kasus penggunaan yang umum dapat berupa menyediakan kebijakan penyimpanan data dalam cache atau transformasi untuk backend lama yang berjalan di lingkungan lokal. Repo sampel apigee adalah tempat yang tepat untuk memulai, dan repo DevRel kami juga berisi contoh template proxy untuk referensi. Selain template kebijakan, tim platform Anda juga dapat menstandarkan pipeline yang akan digunakan developer Anda untuk membangun dan men-deploy proxy mereka. Apigee menawarkan alat dan API pengelolaan yang dapat Anda manfaatkan untuk membuat pipeline CI/CD yang mendukung jalur ideal ini. Kami telah memublikasikan penerapan referensi yang dapat Anda gunakan sebagai titik awal.

Pipeline proxy API MVP dari kode sumber mungkin terlihat mirip dengan ini:

• Analisis kode statis: Memungkinkan Anda melakukan lint kode tanpa eksekusi sebenarnya. Hal ini memungkinkan Anda menjalankan analisis kode statis pada konfigurasi dan kebijakan proxy, termasuk memastikan adanya kebijakan wajib. Analisis kode statis juga mendukung standardisasi melalui konsistensi.
• Pengujian unit: Memvalidasi fungsi dan logika API dengan menguji setiap unit kode seperti class atau metode.
• Deployment: Mengemas paket proxy API dan men-deploy ke lingkungan Apigee. 
• Pengujian integrasi: Melakukan berbagai panggilan API untuk menguji keseluruhan fungsi API.

Lebih lanjut, pipeline juga dapat mendaftarkan API dalam katalog internal, seperti API hub dari Apigee. API hub adalah alat yang membantu organisasi mendokumentasikan, menemukan, dan memublikasikan informasi tentang API mereka. Registry yang dibangun di dalam hub berisi informasi mendetail tentang setiap versi API terkait informasi progresnya dalam siklus proses, termasuk spesifikasi terkait, deployment saat ini, info kepemilikan dan kontak, dependensi, dan banyak lagi. Selain properti bawaan, pelanggan dapat menentukan taksonomi mereka sendiri yang dapat ditelusuri dan difilter oleh pengguna. Untuk lebih membantu meningkatkan kualitas dan konsistensi, API hub juga menawarkan kartu skor yang membuat developer memahami dengan lebih baik bagaimana desain API mereka memenuhi standar yang diharapkan. Registry API hub dapat disinkronkan ke portal developer internal, seperti Backstage, atau alat platform developer internal lainnya.

Terakhir, untuk konsumen eksternal, pipeline dapat memublikasikan produk API ke portal API yang ditampilkan kepada publik bersama dengan dokumentasi tambahan dan panduan pengguna, semuanya dengan branding dan gaya yang disesuaikan.

Saat membangun API dalam skala besar, praktik terbaiknya adalah menggunakan kembali kebijakan umum untuk meningkatkan kecepatan pengembangan dan mengurangi waktu pengiriman. Di Apigee, alur bersama memungkinkan Anda menerapkan standardisasi dan konsistensi di seluruh API. Dengan alur bersama, Anda dapat menggabungkan kebijakan dan resource serta membagikannya di antara beberapa proxy API menggunakan kebijakan FlowCallout atau flow hook. Alur bersama sering dikembangkan secara terpisah dari proxy API, biasanya oleh tim platform atau pakar di bidang tertentu yang bertanggung jawab untuk area tertentu. Misalnya, Anda dapat mengembangkan alur bersama yang menangkap serangkaian kolom permintaan dan respons standar serta menulisnya ke Cloud Logging. Alur lainnya mungkin berupa alur penanganan error yang menghasilkan kode dan pesan error terstandardisasi, atau alur autentikasi yang terintegrasi dengan penyedia identitas pihak ketiga. Pengembangan alur bersama dapat diotomatiskan, diuji, dan di-deploy menggunakan alat dan konsep yang sama seperti proxy API. Beberapa contoh alur bersama umum lainnya dapat ditemukan di sini.

GitOps menjadi populer selama kemunculan DevOps. Framework ini memanfaatkan praktik terbaik seperti menggunakan kontrol versi melalui Git, permintaan pull, pipeline CI/CD, otomatisasi, dan kebijakan kepatuhan. Baca blog ini yang membahas praktik terbaik untuk pengiriman API secara mendetail. Praktik ini dapat diintegrasikan ke dalam jalur ideal untuk developer. Misalnya, developer dapat mendesain API menggunakan Duet AI untuk membuat Spesifikasi OpenAPI sebelum mengirimkannya ke cabang fitur, yang akan memicu permintaan pull. Setelah permintaan pull disetujui dan digabungkan, proses ini akan otomatis memulai pipeline CI/CD, dan prosesnya diulang untuk setiap lingkungan. Di Apigee, tim platform Anda dapat membuat organisasi dan lingkungan yang terpisah untuk men-deploy dan menguji proxy saat berada dalam siklus proses pengembangan. Dengan menggunakan strategi GitOps, setiap cabang repo Git dapat dipetakan ke lingkungan Apigee.

Pelanggan yang menggunakan model bayar sesuai penggunaan Apigee memiliki pilihan berbagai jenis lingkungan dengan beragam kemampuan, dan pelanggan dapat membuat berbagai jenis lingkungan untuk kasus penggunaan yang berbeda-beda.

Dengan menghosting proxy dan kode alur bersama di repositori sumber, dan menggunakan GitOps, Anda dapat membuat jalur ideal yang pasti untuk developer API sehingga mereka dapat berfokus pada perancangan API yang efektif dan menerapkan logika bisnis yang mendasarinya. Untuk lebih memudahkan, developer juga dapat mengembangkan dan menguji secara lokal menggunakan plugin Cloud Code untuk VS Code.

Peningkatan kolaborasi antara developer dan tim platform membebaskan developer dari beban melakukan semuanya sendiri. Dengan mengurangi kompleksitas developer dapat berfokus pada keahlian terbaiknya, yang akan menghasilkan pengalaman yang lebih baik bagi pelanggan. Memperlakukan API dan platform Anda sebagai produk organisasi Anda akan meningkatkan otonomi, kecepatan, kualitas, dan inovasi. Dengan menggunakan strategi yang diuraikan di atas, Anda dapat mengurangi beban developer dan membantu mereka untuk membangun API yang lebih baik. Siap untuk memulai? Anda dapat mendaftar dan mulai membangun aplikasi di sandbox gratis Anda sendiri secara gratis. Ingin mendapatkan informasi lebih detail tentang harga? Lihat harga baru Apigee dan gunakan referensi kami untuk membantu Anda mulai menyematkan pengelolaan API ke platform developer.