Bagaimana pendekatan API-first membentuk masa depan Zonos

Apa itu pendekatan API-first? 

Pendekatan API-first sangat kontras dengan pendekatan code-first, di mana tim memulai dengan merancang fungsionalitas aplikasi, menulis kode, dan kemudian menambahkan API di akhir proses.

Di Zonos, membangun perangkat lunak dengan pendekatan API-first berarti merancang solusi di sekitar API, bukan mengkodekan aplikasi dan menambahkan API kemudian. Ini berarti API kami sangat penting dan produk dalam hak mereka sendiri; kami merancangnya dengan fokus yang intens pada kebutuhan pelanggan, dan kami mendokumentasikan serta merancangnya dengan jelas sebelum menulis kode apa pun.

Manfaat dari pendekatan API-first 

Pendekatan API-first membantu membangun pola pikir berikut:

• Kami memahami bahwa API kami adalah antarmuka utama bagi pelanggan kami, dan oleh karena itu kami melihatnya sebagai hasil publik kami.
• Mendokumentasikan sebelum menulis kode memberi kami kesempatan untuk berpikir, berdiskusi, menyempurnakan, dan mengkomunikasikan tujuan kami dengan tim dan pemangku kepentingan untuk menciptakan produk akhir yang lebih baik.
• Saat kami fokus pada kebutuhan pelanggan kami, kami memahami cara terbaik untuk merancang API yang memenuhi kebutuhan tersebut.

Pola pikir ini menempatkan API dan pelanggan kami di posisi pertama dan sangat penting untuk membangun fondasi di mana setiap orang di Zonos bertanggung jawab atas kesuksesan pelanggan.

Tim pengembangan dapat bekerja secara paralel

Pendekatan API-first melibatkan pembentukan kontrak. Membuat kontrak antara layanan yang diikuti oleh tim di seluruh organisasi memungkinkan tim tersebut untuk bekerja pada beberapa API secara bersamaan. Pengembang tidak harus menunggu pembaruan API dirilis sebelum melanjutkan ke API berikutnya. Tim dapat secara bersamaan menguji API dan ketergantungan API berdasarkan definisi API yang telah ditetapkan sebelumnya.

Mengurangi biaya pengembangan

API dan kode dapat digunakan kembali pada banyak proyek yang berbeda. Di bawah pendekatan API-first, jika tim pengembangan ingin membangun aplikasi baru, mereka tidak harus memulai dari awal, menghemat waktu dan uang. Desain API-first juga memungkinkan sebagian besar masalah diselesaikan sebelum kode apa pun ditulis, yang membantu mencegah masalah saat tiba waktunya untuk mengintegrasikan API dengan aplikasi.

Meningkatkan kecepatan ke pasar

Sebagian besar proses membangun API dapat diotomatisasi menggunakan alat untuk mengimpor file definisi API. Kami memulai dengan menghasilkan tipe inti, definisi, dan skema; dengan file-file tersebut, alat API seperti dokumentasi API, kit pengembangan perangkat lunak (SDK), dan API tiruan dapat dihasilkan secara otomatis. Otomatisasi secara signifikan mempercepat pengembangan API dan aplikasi.

API-first juga memungkinkan penambahan layanan dan teknologi baru ke aplikasi tanpa harus merancang ulang seluruh sistem. Zonos harus mengirimkan fitur ke produksi dengan cepat untuk tetap kompetitif di pasar SaaS lintas batas yang terus berubah. Lebih mudah untuk menghilangkan utang teknis dalam kode dasar daripada memindahkan pelanggan dari API yang dirancang dengan buruk.

Memastikan pengalaman pengembang yang baik

Konsumen API paling sering adalah pengembang, dan pengalaman pengembang (DX) dapat menentukan keberhasilan API. Pendekatan API-first memastikan bahwa pengalaman pengembang positif karena API yang dirancang dengan baik, didokumentasikan dengan baik, dan konsisten lebih mudah dipelajari dan digunakan kembali. Ini juga meningkatkan kecepatan implementasi. Manfaat ini semuanya saling terkait!

Meningkatkan kesuksesan jangka panjang

Pendekatan API-first memungkinkan prototipe dan iterasi yang cepat, yang berarti kami lebih cepat belajar apa yang berhasil dan apa yang tidak. Seperti 1.000 percobaan gagal Eddison sebelum menciptakan bola lampu, API-first berarti kami gagal dengan cepat dan maju dengan pemahaman yang lebih baik tentang cara mencapai kesuksesan. API-first meningkatkan kesuksesan jangka panjang kami dengan memastikan bahwa API dapat diandalkan, konsisten, dan mudah digunakan oleh pengembang.

Mengapa bekerja mundur efektif? 

Pada tahun 2015, saya memiliki kesempatan untuk mendesain ulang situs ecommerce dari merek konsumen yang populer. Saya mengevaluasi berbagai indikator kinerja utama (KPI) terkait dengan sistem yang ada, dan clear di mana perbaikan terbesar dapat dilakukan:

• rate konversi desktop tidak memenuhi standar.
• rate konversi seluler sangat buruk.
• Persentase lalu lintas seluler meningkat pesat dan akan melampaui 50% dari total lalu lintas dalam 12 bulan ke depan. Karena rate konversi seluler yang sangat buruk, sebagian besar lalu lintas yang berasal dari seluler tidak ideal.

Berdasarkan data, apa yang akan menciptakan nilai paling besar bagi pengguna? Itu jelas: memperbaiki masalah dengan pengalaman pengguna seluler situs. Oleh karena itu, saya mengambil pendekatan mobile-first untuk mendesain ulang situs. Ini berarti bahwa semua desain, arsitektur, API, dll. pertama-tama mempertimbangkan pengalaman seluler. Ini adalah kebalikan dari pendekatan tradisional pada saat itu, yang pertama-tama berfokus pada pengalaman desktop, sering kali meninggalkan pengalaman seluler sebagai tambahan yang canggung dengan tingkat konversi yang buruk. Pendekatan mobile-first juga memerlukan lebih banyak usaha di awal—ini bukan jalan yang mudah. Arsitektur baru diperlukan, API baru perlu ditulis, dan beberapa desain diperlukan untuk setiap breakpoint.

Pendekatan mobile-first menghasilkan peningkatan signifikan dalam rate konversi seluler. Arsitektur baru juga menghasilkan peningkatan yang mengesankan dalam rate konversi desktop. Pendekatan ini berhasil karena mengidentifikasi cara menciptakan nilai pengguna maksimum dan memfokuskan seluruh pendekatan pada penyediaan nilai tersebut. Ini menciptakan pola pikir yang tepat sejak awal. Demikian pula—meskipun mungkin terasa seperti bekerja mundur—pendekatan API-first menciptakan peluang untuk mengidentifikasi masalah yang menyeluruh dan kemudian membangun fondasi untuk memperbaiki masalah tersebut.

Apa tanggung jawab rekayasa? 

Pola pikir API-first telah dan akan terus membawa Zonos menuju kesuksesan, dan rekayasa memainkan peran integral. Ini adalah tanggung jawab kami untuk selalu mempertahankan pola pikir API-first. Ini berarti bahwa kami terus-menerus mengajukan pertanyaan yang menjaga fokus pada API kami, seperti: “Bagaimana API kami dapat memenuhi kebutuhan pelanggan” Ini juga berarti bahwa kami selalu menjawab pertanyaan tentang fitur dan fungsionalitas dengan tautan ke dokumentasi API kami. Jika dokumentasi tidak ada, maka kami membuatnya—bekerja sama dalam tim lintas fungsi untuk memastikan bahwa Zonos memiliki dokumentasi API yang luar biasa.