Kembali ke blog

Satu API, dua aplikasi mobile, satu platform booking.

Arsitektur · · Oleh Firmansyah Maulana

Pertanyaan arsitektur di balik integrasi platform web VillaHub dengan iOS dan Android.

Mulai dari batas yang sama

VillaHub menggabungkan back end Laravel, platform web, dan aplikasi React Native untuk iOS serta Android. Lingkup proyeknya mencakup REST API bersama dan alur berbeda untuk tamu, pemilik, affiliator, marketing, dan keuangan.

Kombinasi ini menjadikan API lebih dari sekadar jalur pertukaran data. API adalah batas tempat aturan booking harus berlaku konsisten, apa pun antarmuka yang mengirim permintaan. Reservasi dari ponsel memerlukan pengecekan ketersediaan dan hak akses yang sama dengan reservasi dari web.

Hak akses berada di server

Dashboard sesuai peran membantu pengguna menemukan alat yang tepat. Namun, dashboard itu sendiri bukan kontrol akses. Menyembunyikan tautan keuangan dari antarmuka tamu tidak mencegah seseorang mengakses endpoint-nya.

Dalam produk multi-peran, otorisasi perlu mempertimbangkan aksi sekaligus sumber daya: siapa yang meminta, booking atau properti mana yang terdampak, dan apakah orang tersebut berhak melakukan perubahan. Semua client diuntungkan ketika aturan memiliki satu implementasi yang menjadi acuan.

Perlakukan respons sebagai kontrak

Rilis web dan mobile tidak selalu bersamaan. Website dapat langsung diperbarui, sementara aplikasi yang terpasang mungkin masih versi lama. Bentuk respons, kode error, pagination, dan makna setiap field perlu berperilaku konsisten.

Penambahan field biasanya lebih mudah dilakukan dengan aman daripada mengganti nama atau menghapus field yang ada. Pertanyaan review yang berguna: apa yang terjadi saat aplikasi versi kemarin memanggil API versi besok?

Kode bersama tetap membutuhkan pengujian per platform

React Native memungkinkan berbagi kode antara iOS dan Android, tetapi perilaku rilis tetap dipengaruhi setiap platform. Navigasi, keyboard, perizinan, dan gangguan jaringan perlu diperiksa di keduanya.

Hasil yang diharapkan dari arsitektur bersama adalah konsistensi aturan produk, sekaligus ruang bagi setiap antarmuka untuk bekerja secara natural. Studi kasus VillaHub menjelaskan lingkup pekerjaan; catatan ini membahas pertimbangan desain umum tanpa membuka detail implementasi privat.

Konteks: lingkup proyek yang telah dipublikasikan. Pertimbangan desain dalam artikel ini merupakan panduan umum, bukan pembukaan detail implementasi privat. VillaHub — Baca studi kasus.

Bacaan terkait

Ada posisi atau proyek yang ingin dibahas?

Untuk peluang kerja, kolaborasi, dan diskusi tentang software.

Mari berdiskusi