Pemeriksaan versi aplikasi di layar pembuka, sebelum login. Server memberi versi terbaru dan versi minimal yang masih boleh dipakai; client memutuskan menampilkan layar "wajib perbarui" atau tawaran pembaruan. Nilai dikelola pengelola Absenova di panel platform (Aplikasi Mobile → Versi Aplikasi) dan berlaku tanpa rilis aplikasi. Konvensi umum ada di README.md.
| Atribut | Nilai |
|---|---|
| Endpoint | GET /app/version |
| Sumber kode | AppVersionController, ShowAppVersionRequest, AppVersionResource, AppVersionService, model AppVersion, panel App\Filament\Platform\Resources\AppVersions |
| Contoh direkam | 2026-10-22, HTTP kernel Laravel, basis data SQLite sekali pakai sesudah migrasi 2026_10_22_100000_create_app_versions_table, APP_LOCALE=id. Nilai Android diisi lewat formulir panel platform (Livewire) |
| Data uji | Android: versi terbaru 1.2.0 (versionCode 12), minimal versionCode 10. store_url di contoh adalah data uji; tautan sebenarnya diisi pengelola di panel |
Periksa versi
GET /app/version
Deskripsi: informasi versi untuk satu platform. Bukan data perusahaan: nilainya sama untuk seluruh pelanggan Absenova.
| Auth & Middleware | |
|---|---|
| Token | tidak |
| Middleware | throttle:api |
| Route name | api.v1.app.version |
Header: Accept: application/json
Parameter (ShowAppVersionRequest)
| Nama | Lokasi | Tipe | Wajib | Aturan validasi (FormRequest) |
|---|---|---|---|---|
platform |
query | string (enum) | ya | required, salah satu DevicePlatform (ANDROID, IOS) |
Contoh Request
GET /api/v1/app/version?platform=ANDROID HTTP/1.1
Accept: application/json
Contoh Response Sukses (200, 2026-10-22 08:05 WIB)
{
"success": true,
"message": "Informasi versi aplikasi berhasil diambil.",
"data": {
"latest_version_name": "1.2.0",
"latest_version_code": 12,
"minimum_version_code": 10,
"store_url": "https://play.google.com/store/apps/details?id=id.absenova.app",
"message": "Versi baru memperbaiki presensi offline. Perbarui aplikasi untuk melanjutkan."
}
}
Platform yang belum diatur di panel (200, angka 0 sehingga tidak pernah memaksa pembaruan):
{
"success": true,
"message": "Informasi versi aplikasi berhasil diambil.",
"data": {
"latest_version_name": null,
"latest_version_code": 0,
"minimum_version_code": 0,
"store_url": null,
"message": null
}
}
Field data
| Field | Tipe | Null | Keterangan |
|---|---|---|---|
latest_version_name |
string | ya | versionName terbaru di toko aplikasi, untuk ditampilkan. null bila platform belum diatur |
latest_version_code |
integer | tidak | versionCode terbaru. 0 bila belum diatur |
minimum_version_code |
integer | tidak | versionCode terendah yang masih boleh dipakai; selalu <= latest_version_code. 0 bila belum diatur |
store_url |
string | ya | tautan halaman aplikasi di toko; null bila belum diisi |
message |
string | ya | pesan untuk layar pembaruan, teks polos; null bila kosong |
Logika client (bandingkan versionCode bilangan bulat, bukan string versi):
| Kondisi | Tindakan client |
|---|---|
BuildConfig.VERSION_CODE < minimum_version_code |
layar wajib perbarui; tombol membuka store_url; aplikasi tidak dilanjutkan |
minimum_version_code <= VERSION_CODE < latest_version_code |
tawarkan pembaruan, boleh dilewati |
VERSION_CODE >= latest_version_code |
lanjut tanpa tawaran |
Tampilkan message bila tidak null. Bila store_url null, arahkan ke toko aplikasi berdasarkan
nama paket aplikasi.
Contoh Response Error
| Kondisi | HTTP | message |
|---|---|---|
platform kosong atau tidak dikenal |
422 | Data yang dikirim tidak lolos pemeriksaan. |
| Batas laju terlampaui | 429 | Terlalu banyak percobaan. Tunggu beberapa saat lalu coba lagi. |
{
"success": false,
"message": "Data yang dikirim tidak lolos pemeriksaan.",
"errors": {
"platform": [
"Pilihan pada kolom jenis perangkat tidak sah."
]
}
}
Catatan
- Idempotency: tidak relevan (GET).
- Rate limit:
api, 60 per menit per IP (tanpa token). Respons membawaX-RateLimit-Limit: 60danX-RateLimit-Remaining; request ke-61 dalam satu menit dijawab 429 denganRetry-AfterdanX-RateLimit-Reset. - FeatureGate / modul: tidak ada.
- Status langganan: tidak diperiksa (tanpa token dan bukan data perusahaan).
- Perubahan di panel berlaku pada request berikutnya; tidak ada cache server.