Bagaimana pendekatan API-first membentuk masa depan Zonos

Apa itu pendekatan API-first? 

Pendekatan API-first sangat berbeda dengan pendekatan code-first, di mana sebuah tim dimulai dengan merancang fungsionalitas aplikasi, menulis kode, dan kemudian menambahkan APIs di akhir proses.

Di Zonos, membangun perangkat lunak menggunakan pendekatan API-first berarti merancang solusi di sekitar API, bukan mengkode aplikasi dan menambahkan API kemudian. Ini berarti APIs kami adalah yang terpenting dan produk dalam diri mereka sendiri; kami merancangnya dengan fokus intens pada kebutuhan pelanggan, dan kami mendokumentasikan dan menarsitek mereka dengan jelas sebelum menulis kode apa pun.

Manfaat pendekatan API-first 

Pendekatan API-first membantu membangun pola pikir berikut:

• Kami memahami bahwa APIs kami adalah antarmuka utama bagi pelanggan kami, dan oleh karena itu kami menganggapnya sebagai deliverable publik kami.
• Mendokumentasikan sebelum menulis kode memberi kami kesempatan untuk mempertimbangkan, mendiskusikan, menyempurnakan, dan mengomunikasikan tujuan kami dengan tim dan stakeholder kami untuk menciptakan produk akhir yang lebih baik.
• Saat kami fokus pada kebutuhan pelanggan kami, kami memahami bagaimana cara terbaik untuk merancang APIs yang memenuhi kebutuhan tersebut.

Pola pikir ini menempatkan APIs dan pelanggan kami di tempat 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 penetapan kontrak. Membuat kontrak antar layanan yang diikuti oleh tim di seluruh organisasi memungkinkan tim tersebut untuk bekerja pada beberapa APIs pada waktu yang sama. Developer tidak harus menunggu pembaruan API dirilis sebelum melanjutkan ke API berikutnya. Tim dapat secara bersamaan melakukan mock test APIs dan ketergantungan API berdasarkan definisi API yang telah ditetapkan sebelumnya.

Mengurangi biaya pengembangan

APIs dan kode dapat digunakan kembali di banyak proyek berbeda. Dalam 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 saatnya mengintegrasikan APIs dengan aplikasi.

Meningkatkan kecepatan ke pasar

Banyak proses membangun APIs dapat diotomatisasi menggunakan alat untuk mengimpor file definisi API. Kami mulai dengan membuat tipe inti, definisi, dan skema; dengan file tersebut, alat API seperti dokumentasi API, kit pengembangan perangkat lunak (SDKs), dan API mock dapat dibuat secara otomatis. Otomasi secara signifikan mempercepat pengembangan APIs dan aplikasi.

API-first juga memungkinkan untuk menambahkan 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 yang mendasarinya daripada memigrasikan pelanggan dari API yang dirancang dengan buruk.

Memastikan pengalaman developer yang baik

Konsumen API paling sering adalah developer, dan pengalaman developer (DX) dapat membuat atau menghancurkan kesuksesan API. Pendekatan API-first memastikan bahwa pengalaman developer adalah positif karena API yang dirancang dengan baik, terdokumentasi dengan baik, dan konsisten lebih mudah dipelajari dan digunakan kembali. Ini juga meningkatkan kecepatan implementasi. Semua manfaat ini saling terhubung!

Meningkatkan kesuksesan jangka panjang

Pendekatan API-first memungkinkan pembuatan prototipe dan iterasi yang cepat, yang berarti kami belajar lebih cepat apa yang berhasil dan apa yang tidak. Seperti 1.000 percobaan gagal Edison 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 APIs dapat diandalkan, konsisten, dan mudah digunakan oleh developer.

Mengapa bekerja mundur efektif? 

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

• Tingkat konversi desktop standar di bawah.
• Tingkat konversi mobile sangat buruk.
• Persentase lalu lintas mobile meningkat dengan cepat dan akan melampaui 50% dari total lalu lintas dalam 12 bulan ke depan. Karena tingkat konversi mobile yang sangat buruk, sebagian besar lalu lintas menjadi mobile tidak ideal.

Mengingat data tersebut, apa yang akan menciptakan nilai terbanyak bagi pengguna? Itu jelas: memperbaiki masalah dengan pengalaman pengguna seluler situs. Oleh karena itu, saya mengambil pendekatan mobile-first untuk merancang ulang situs. Ini berarti bahwa semua desain, arsitektur, APIs, dll. pertama-tama mempertimbangkan pengalaman mobile. Ini adalah kebalikan dari pendekatan tradisional pada waktu itu, yang fokus pertama pada pengalaman desktop, sering meninggalkan pengalaman mobile sebagai pemikiran sampingan yang canggung dengan tingkat konversi yang buruk. Pendekatan mobile-first juga membutuhkan lebih banyak usaha di depan—ini bukan jalan yang mudah. Arsitektur baru diperlukan, APIs baru harus ditulis, dan beberapa desain diperlukan untuk setiap breakpoint.

Pendekatan mobile-first menghasilkan peningkatan signifikan dalam tingkat konversi mobile. Arsitektur baru juga menghasilkan keuntungan mengesankan dalam tingkat konversi desktop. Pendekatan ini berhasil karena mengidentifikasi cara menciptakan nilai pengguna maksimal dan fokus seluruh pendekatan pada penyediaan nilai itu. 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 mencakup semuanya dan kemudian membangun fondasi untuk memperbaiki masalah tersebut.

Apa tanggung jawab engineering? 

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