HTTP Attendance API

Genel bakış

Herhangi bir istemciden devam giriş-çıkışlarını, heartbeat'leri ve abonelik kontrollerini almak için cihazdan bağımsız bir HTTPS giriş kapısı.

HTTP Attendance API, /api/attendance/v1/{op} yolundaki cihazdan bağımsız giriş kapısıdır. Her isteği cihaz seri numarası (sn) ve auth-token başlıklarıyla doğrular, ardından veriyi alır. punch (tanınan bir devam olayı), heartbeat (cihaz varlığı), validity (abonelik kontrolü) ve config sunar. Giriş-çıkışlar paylaşılan işlem hattına akar; yerel HTTP, TCP ve MQTT aktarımlarıyla aynı depolamayı ve müşteri sunucusuna aşağı akış push'unu sağlar — böylece devam verisi nasıl gelirse gelsin entegrasyonlar tutarlı kalır.

APIRESTHTTPSJSONC++

Kullanıldığı yerler:Okullar, Üniversiteler ve Kampüs

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}

Yetenekler

Neler yapar

Giriş-Çıkış Alma

Kullanıcı, zaman damgası, GİRİŞ/ÇIKIŞ durumu, giriş türü ve isteğe bağlı konumla tanınan bir devam olayını POST edin.

Varlık Bildirme

Bir cihazı gövdesiz bir heartbeat göndererek çevrimiçi olarak işaretleyin.

Geçerlilik Kontrolü

Veri göndermeden önce cihazın devam aboneliğinin etkin olup olmadığını sorgulayın.

Birleşik İşlem Hattı

Her giriş-çıkış, yerel TCP ve MQTT alımıyla aynı depolama ve push yoluna düşer.

Özellikler

Her şey dahil

Edge, uygulama, web ve hibrit istemciler için /api/attendance/v1/{op} üzerinde tek HTTPS giriş noktası
Başlık tabanlı kimlik doğrulama: cihaz seri numarası (sn) artı auth-token, abonelik denetimiyle
punch endpoint'i tanınan bir devam olayını alır (kullanıcı, zaman, GİRİŞ/ÇIKIŞ, giriş türü, isteğe bağlı coğrafi konum)
heartbeat endpoint'i varlık takibi için bir cihazı çevrimiçi olarak işaretler
validity endpoint'i, bir istemci veri göndermeden önce canlı abonelik durumunu döndürür
Paylaşılan işlem hattı: yerel motorlarla aynı depolama ve müşteri sunucusuna push
Eksik seri numarası, bilinmeyen cihaz, geçersiz token veya etkin olmayan abonelik için tutarlı JSON hata sözleşmesi
Gövde boyutu sınırları ve istek sınırlamasıyla nginx önünde