Fingerspot Developer API
REST API gateway untuk perangkat absensi Fingerspot (fingerspot.io SDK Online).
Pola Respons
Operasi sinkron (get_attlog, get_device) mengembalikan payload lengkap
langsung di body respons HTTP.
Operasi asinkron mengembalikan konfirmasi {"success": true, "trans_id": "..."} secara langsung
dan mengirimkan hasil aktualnya melalui callback HTTP POST berformat JSON ke URL webhook yang dikonfigurasi
untuk perangkat target. Nilai trans_id pada callback selalu sama dengan trans_id yang dikirim pada
permintaan awal, sehingga klien dapat mengaitkan callback dengan permintaan yang sesuai.
Push Attlog Real-time
Selain callback perintah-respons, platform secara terus-menerus mengirimkan
event pemindaian kehadiran real-time (type: "attlog") ke URL webhook
setiap perangkat yang dikonfigurasi setiap kali perangkat mengirim hasil
pemindaian — terlepas dari panggilan API apa pun.
URL Webhook
Setiap perangkat memiliki URL webhook yang didaftarkan di platform. Ekspresi
callback dalam spesifikasi ini menggunakan {$request.body#/cloud_id} sebagai
placeholder untuk menandakan bahwa tujuan callback ditentukan oleh cloud_id
dalam body permintaan; URL sebenarnya adalah URL yang terdaftar untuk perangkat tersebut.
Authentication
- HTTP: Bearer Auth
Token API yang diperoleh dari portal Developer Fingerspot.
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |