Bagian 17 dari 19
API Mobile v1
Dokumentasi teknis REST API untuk integrasi aplikasi mobile, autentikasi Bearer Token, servis, dan absensi.
Ringkasan & Sasaran Modul
Panduan integrasi REST API v1 untuk pengembang aplikasi mobile (Android/iOS) atau sistem pihak ketiga dengan autentikasi Sanctum Bearer Token.
- Endpoint Autentikasi Login (POST /api/v1/auth/login)
- Profil Pengguna & Context Toko Aktif (GET /api/v1/user)
- Manajemen & Detail Servisan (GET /api/v1/services & {id})
- Cek Servis Publik tanpa login (GET /api/v1/service/check/{code})
- API Absensi GPS & Kamera (Today, Clock-In, Clock-Out)
Alur Kerja Berurutan
1
Kirim Request Login
POST email & password ke endpoint auth untuk memperoleh Bearer Token.
2
Set Header Auth
Sematkan header Authorization: Bearer {TOKEN} di setiap request.
3
Panggil Endpoint
Akses endpoint servisan, absensi harian, atau profil pengguna.
4
Tangani Response
Parsing response JSON standar lengkap dengan status code dan payload.
17.1 & 17.2 Autentikasi Login dan Profil Pengguna
Mendapatkan token akses:
POST
/api/v1/auth/login
Request Payload (JSON)
{
"email": "teknisi@toko.com",
"password": "rahasia123"
}
Sample Response (JSON)
{
"status": "success",
"token": "1|xyz987token...",
"user": {
"id": 5,
"name": "Ahmad Teknisi",
"id_role": 3
}
}
17.3 & 17.4 Daftar Servis dan Cek Servis Publik
Mengakses data perbaikan:
GET
/api/v1/services?status=proses
Sample Response (JSON)
{
"data": [
{
"id": 101,
"kode_servis": "SRV-2026-089",
"nama_pelanggan": "Budi Santoso",
"tipe_elektronik": "iPhone 13",
"status": "proses",
"biaya_total": 450000
}
]
}
17.5 Absensi Harian via API
Presensi karyawan melalui aplikasi mobile:
POST
/api/v1/attendance/clock-in
Request Payload (JSON)
{
"latitude": -6.2088,
"longitude": 106.8456,
"catatan": "Hadir tepat waktu"
}
Sample Response (JSON)
{
"status": "success",
"message": "Clock-in berhasil dicatat pada 08:30 WIB",
"data": {
"clock_in": "2026-08-17 08:30:15",
"status": "hadir"
}
}
Daftar Isi Bagian Ini
- 17.1 & 17.2 Autentikasi Login dan Profil Pengguna
- 17.3 & 17.4 Daftar Servis dan Cek Servis Publik
- 17.5 Absensi Harian via API