HTTP Attendance API

Satu pintu masuk HTTPS untuk klien mana pun yang menghasilkan absensi. HTTP Attendance API mengautentikasi berdasarkan serial perangkat dan token, lalu mengalirkan setiap absen yang dikenali ke pipeline penyimpanan dan push-pelanggan yang sama seperti setiap engine Cams native.

Mulai Dokumentasi pengembang

Ikhtisar

Pintu masuk HTTPS yang tidak bergantung pada perangkat untuk menerima absen, heartbeat, dan pemeriksaan langganan dari klien mana pun.

HTTP Attendance API adalah pintu depan yang tidak bergantung pada perangkat di path /api/attendance/v1/{op}. API ini mengautentikasi setiap permintaan melalui header serial perangkat (sn) dan auth-token, lalu menerima data. API ini menyediakan punch (satu event absensi yang dikenali), heartbeat (kehadiran perangkat), validity (pemeriksaan langganan), dan config. Absen mengalir ke pipeline bersama, menghasilkan penyimpanan dan push ke server pelanggan yang identik dengan transport HTTP, TCP, dan MQTT native — sehingga integrasi tetap konsisten apa pun cara absensi tiba.

APIRESTHTTPSJSONC++

Digunakan di:Sekolah, Perguruan Tinggi & Kampus

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

Kemampuan

Apa yang dilakukannya

Terima Sebuah Absen

POST satu event absensi yang dikenali dengan pengguna, stempel waktu, status IN/OUT, jenis input, dan lokasi opsional.

Laporkan Kehadiran Perangkat

Kirim heartbeat untuk menandai perangkat online tanpa body apa pun.

Periksa Validitas

Tanyakan apakah langganan absensi perangkat aktif sebelum mengirim data.

Pipeline Terpadu

Setiap absen masuk ke jalur penyimpanan dan push yang sama dengan ingest TCP dan MQTT native.

Fitur

Semua sudah termasuk

Satu pintu masuk HTTPS untuk klien edge, aplikasi, web, dan hybrid di /api/attendance/v1/{op}
Autentikasi berbasis header: serial perangkat (sn) plus auth-token, dengan gerbang langganan
Endpoint punch menerima event absensi yang dikenali (pengguna, waktu, IN/OUT, jenis input, geolokasi opsional)
Endpoint heartbeat menandai perangkat online untuk pelacakan kehadiran
Endpoint validity mengembalikan status langganan langsung sebelum klien mengirim data
Pipeline bersama: penyimpanan dan push ke server pelanggan yang identik dengan engine native
Kontrak error JSON yang konsisten untuk serial hilang, perangkat tidak dikenal, token tidak valid, atau langganan tidak aktif
Di depan nginx dengan batas ukuran body dan pembatasan laju

Bangun dengan HTTP Attendance API

Ambil kunci, baca dokumentasi, dan rilis. Tim kami membantu integrasi pertama Anda.

Bicara dengan engineer WhatsApp

FAQ

Pertanyaan umum

Apa yang dilakukan HTTP Attendance API?

API ini adalah pintu depan yang tidak bergantung pada perangkat yang menerima absen absensi yang dikenali, heartbeat, dan pemeriksaan langganan, mengautentikasinya berdasarkan serial perangkat dan token, lalu meneruskannya ke pipeline absensi Cams bersama.

Bagaimana permintaan diautentikasi?

Setiap permintaan membawa header serial perangkat (sn) dan header auth-token; keduanya harus valid. Endpoint biometrik juga memerlukan langganan absensi yang aktif.

Apakah absensi dari HTTP diperlakukan sama dengan dari perangkat?

Ya. Absen mengalir ke pipeline yang sama dengan engine HTTP, TCP, dan MQTT native, sehingga penyimpanan dan push hilir identik apa pun transportnya.