# Rencana API mobile

## Tersedia dalam kerangka

`GET /api/mobile/v1/health`: respons JSON tanpa pemeriksaan database. Runtime PHP belum
diuji pada lingkungan ini.

## Tahap uji QR (belum dibuat)

| Endpoint rencana                     | Fungsi                                                                              |
| ------------------------------------ | ----------------------------------------------------------------------------------- |
| POST /api/mobile/v1/test/qr-sessions | Membuat token acak berumur pendek untuk outlet/perangkat uji yang ditentukan server |
| POST /api/mobile/v1/test/scans       | Memeriksa QR dan menyimpan hasil scan uji, dengan idempotensi                       |
| GET /api/mobile/v1/test/scans        | Membaca log uji dengan otorisasi dan pagination                                     |

Simpan hash token QR dan waktu UTC server, bukan token mentah pada log. QR bersama dapat
dipakai banyak scanner; ID request unik mencegah duplikasi retry. Gunakan tabel uji,
jangan menganggap scan sebagai absensi resmi. Jangan menerima outlet/user ID bebas tanpa
hak server. Endpoint penerbit/log harus dibatasi akses sebelum dihubungkan ke jaringan.

## Tahap operasional (belum dibuat)

Login memakai master akun website setelah verifikasi; sesi mobile terpisah. Aktivasi dan
persetujuan media outlet sekali di awal; sesi perangkat dapat dicabut. QR dinamis
dipakai bersama tantangan transaksi, verifikasi perangkat/lokasi/shift, transaksi MySQL
atomik, koreksi dan audit. Aplikasi karyawan/outlet hanya mengakses HTTPS API, bukan
MySQL langsung.

Konfigurasi database, CORS allowlist, autentikasi, rate limit, akses admin, retensi dan
implementasi Flutter akan ditambahkan saat endpoint terkait dibangun. Tidak ada bypass
autentikasi produksi dalam kerangka ini.
