API Mesin Fingerprint

BKD Provinsi Kalimantan Timur

Contoh: [[ baseUrl ]] + /api/mesin/... atau /api/face/...

Dark

Header: Authorization: Bearer <token>

ℹ️ Ringkasan Endpoint

📡 Koneksi Mesin

  • GET /api/mesin/cek-koneksi/by-ip?ip=xxx – Cek koneksi & sinkron waktu
  • GET /api/mesin/cek-koneksi-gateway/by-ip?gateway=xxx – Ping gateway
  • POST /api/mesin/restart-mesin?ip=xxx – Restart mesin fingerprint

🕒 Attendance dari Mesin

  • GET /api/mesin/by-ip?ip=xxx[&port=4370] – Semua log
  • GET /api/mesin/by-ip-tanggal?ip=xxx&tanggal=YYYY-MM-DD[&port=4370] – Per tanggal
  • GET /api/mesin/by-ip-bulan?ip=xxx&bulan=YYYY-MM[&port=4370] – Per bulan
  • GET /api/mesin/tarik-ke-temp?ip=xxx – Tarik ke temp_absensi_pegawai
  • GET /api/mesin/hapus-data?ip=xxx – Simpan & hapus dari mesin
  • GET /api/mesin/export-dat?ip=xxx – Ekspor .dat
  • POST /api/mesin/push – Terima push (text/plain)

🧩 Mesin (CRUD)

  • POST /api/mesin/mesin/insert – Insert (BIGINT auto-inc)
  • POST /api/mesin/mesin/upsert – Upsert by ip_mesin
  • GET /api/mesin/mesin/list?search=...&page=1&per_page=20&sort_by=...&sort_dir=...&simple=1 – List mesin (filter & pagination)
  • GET /api/mesin/mesin/<id>[?include_deleted=1] – Detail
  • PUT /api/mesin/mesin/<id> – Update mesin (partial)
  • DELETE /api/mesin/mesin/<id>[?reason=...] – Soft delete
  • POST /api/mesin/mesin/<id>/restore – Restore

👤 Face Recognition Absensi

  • GET /api/face/health – Cek status modul face recognition
  • POST /api/face/register – Register foto referensi wajah pegawai (nip, image – multipart/form-data)
  • POST /api/face/absen – Absensi via wajah (nip, jenis masuk/pulang, image, optional lat/lng)
  • POST /api/face/verify – Verifikasi dua foto (img1, img2 – multipart/form-data) atau dua link gambar (url1, url2). (opsional: nip untuk logging)
Method Path Deskripsi Auth Action
[[ e.method ]] [[ e.desc ]] [[ e.auth ? 'Bearer' : '-' ]]
Tidak ada hasil
Menampilkan [[ filtered.length ]] dari [[ endpoints.length ]] endpoint.

🧪 Contoh JSON & cURL

📎 cURL Mesin

$ curl -i -H "Authorization: Bearer <TOKEN>" "[[ baseUrl ]]/api/mesin/mesin/list?page=1&per_page=10"
$ curl -i -X POST -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '[[ pretty(createJson) ]]' "[[ baseUrl ]]/api/mesin/mesin/insert"
$ curl -i -X PUT -H "Authorization: Bearer <TOKEN>" -H "Content-Type: application/json" \
  -d '[[ pretty(updateJson) ]]' "[[ baseUrl ]]/api/mesin/mesin/123"
$ curl -i -X DELETE -H "Authorization: Bearer <TOKEN>" "[[ baseUrl ]]/api/mesin/mesin/123?reason=Mesin%20dipindahkan"

👤 cURL Face Recognition

$ curl -i "[[ baseUrl ]]/api/face/health"
$ curl -i -X POST "[[ baseUrl ]]/api/face/register" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "nip=197901012005011001" \
  -F "image=@/path/ke/foto_referensi.jpg"
$ curl -i -X POST "[[ baseUrl ]]/api/face/absen" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "nip=197901012005011001" \
  -F "jenis=masuk" \
  -F "lat=-0.50" \
  -F "lng=117.13" \
  -F "image=@/path/ke/selfie.jpg"
$ curl -i -X POST "[[ baseUrl ]]/api/face/verify" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "nip=197901012005011001" \
  -F "img1=@/path/ke/foto1.jpg" \
  -F "img2=@/path/ke/foto2.jpg"
$ curl -i -X POST "[[ baseUrl ]]/api/face/verify" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "nip=197901012005011001" \
  -F "url1=https://example.com/foto_referensi.jpg" \
  -F "url2=https://example.com/selfie_uji.jpg"

🧰 Playground

Request URL
[[ finalPgUrl ]]
Status
[[ pgStatus ]]
Response (JSON)
[[ JSON.stringify(pgJson, null, 2) ]]
Response (Text)
[[ pgText ]]

📷 Face Playground (Camera + GPS + Register + Verify)

1️⃣ Absensi via Wajah (Kamera + GPS) → /api/face/absen

Koordinat akan dikirim sebagai lat dan lng ke /api/face/absen.

Pastikan sudah capture foto dari kamera sebelum mengirim.

Status
[[ face.status ]]

Kamera

Kamera belum aktif. Klik Start Camera.

Preview Foto Ter-capture

Preview foto
Belum ada foto. Aktifkan kamera dan klik Capture Frame.
Response (JSON)
[[ JSON.stringify(face.json, null, 2) ]]
Response (Text)
[[ face.text ]]

2️⃣ Register & Verifikasi Wajah via API

👤 Register Wajah → /api/face/register

Gunakan untuk menyimpan foto referensi wajah pegawai (1 kali per pegawai).
Body: nip, image (multipart/form-data).

Jika "Gunakan foto hasil Capture Frame" dicentang, sistem akan mengirim foto dari kamera sebagai image. Jika tidak, gunakan upload file biasa.

Status
[[ register.status ]]
Response (JSON)
[[ JSON.stringify(register.json, null, 2) ]]
Response (Text)
[[ register.text ]]

🔍 Verifikasi 2 Foto → /api/face/verify

Bandingkan dua foto wajah (bukan absensi), misalnya testing threshold.
Body bisa berupa:
- img1, img2 (file, multipart/form-data), atau
- url1, url2 (link gambar).
Opsional: nip untuk keperluan logging.

Mode Input

Backend akan mendownload gambar dari URL tersebut lalu melakukan face verification.

Status
[[ verify.status ]]
Response (JSON)
[[ JSON.stringify(verify.json, null, 2) ]]
Response (Text)
[[ verify.text ]]
[[ toast ]]