API Service di Elysia-Light
Elysia-Light menyediakan pola API service yang terstruktur untuk membantu membangun endpoint backend secara konsisten, mudah dirawat, dan siap untuk skala production. Pendekatan ini memisahkan routing, controller, dan model agar setiap bagian memiliki tanggung jawab yang jelas.
Struktur Dasar API
Dalam Elysia-Light, API dibangun dengan membagi tanggung jawab ke beberapa layer utama: route sebagai pemetaan endpoint, controller sebagai pengelola request dan response, serta model sebagai representasi data. Struktur ini menjaga agar route tetap tipis dan logika bisnis tidak tercampur.
Route: Pemetaan Endpoint
Route bertugas mendefinisikan HTTP method dan path API. Di Elysia-Light, route dikelompokkan menggunakan group agar namespace API jelas dan mudah dikembangkan. Route sebaiknya hanya berisi pemetaan endpoint dan delegasi ke controller.
Kode berhasil di copy!
5
Tips: Jaga agar route tidak berisi logika bisnis. Semua proses sebaiknya didelegasikan ke controller atau service.
Controller: Pengelola Request dan Response
Controller menjadi pusat pengolahan request. Di sinilah validasi, permission, pemanggilan model, dan penentuan response dilakukan. Elysia-Light menyediakan ControllerContext untuk mempermudah interaksi dengan request dan response.
Kode berhasil di copy!
5
Model: Representasi Data
Model di Elysia-Light berfungsi sebagai representasi tabel atau entity data. Model menyediakan konfigurasi field yang boleh diisi, dipilih, dan dicari, serta utility query agar controller tetap bersih dari detail database.
Kode berhasil di copy!
5
Best Practice
Gunakan controller untuk orkestrasi, model untuk data, dan utilitas untuk kebutuhan lintas modul. Dengan pola ini, API tetap mudah dirawat meskipun jumlah endpoint terus bertambah.