HTTP Attendance API

Przegląd

Niezależne od urządzenia, bezpieczne wejście HTTPS do przyjmowania odbić obecności, sygnałów heartbeat i sprawdzania subskrypcji z dowolnego klienta.

HTTP Attendance API to niezależne od urządzenia wejście pod ścieżką /api/attendance/v1/{op}. Uwierzytelnia każde żądanie po nagłówkach numeru seryjnego urządzenia (sn) i auth-token, a następnie przyjmuje dane. Udostępnia punch (jedno rozpoznane zdarzenie obecności), heartbeat (obecność urządzenia), validity (sprawdzenie subskrypcji) i config. Odbicia trafiają do wspólnego potoku, zapewniając identyczne przechowywanie i dalsze przekazywanie na serwer klienta jak natywne transporty HTTP, TCP i MQTT — dzięki temu integracje pozostają spójne niezależnie od sposobu dostarczenia obecności.

APIRESTHTTPSJSONC++

Używane w:Szkoły, uczelnie i kampusy

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}

Możliwości

Co potrafi

Przyjmij odbicie

Wyślij POST z jednym rozpoznanym zdarzeniem obecności: użytkownik, znacznik czasu, stan IN/OUT, typ wejścia i opcjonalna lokalizacja.

Zgłaszaj obecność urządzenia

Wyślij heartbeat, aby oznaczyć urządzenie jako online, bez żadnej treści żądania.

Sprawdź ważność

Sprawdź, czy subskrypcja obecności urządzenia jest aktywna, zanim wyślesz dane.

Ujednolicony potok

Każde odbicie trafia do tej samej ścieżki przechowywania i przekazywania co natywne wejście TCP i MQTT.

Funkcje

Wszystko w zestawie

Jedno wejście HTTPS dla klientów edge, aplikacji, webowych i hybrydowych pod /api/attendance/v1/{op}
Uwierzytelnianie w nagłówkach: numer seryjny urządzenia (sn) plus auth-token, z bramką subskrypcji
Endpoint punch przyjmuje rozpoznane zdarzenie obecności (użytkownik, czas, IN/OUT, typ wejścia, opcjonalna geolokalizacja)
Endpoint heartbeat oznacza urządzenie jako online na potrzeby śledzenia obecności
Endpoint validity zwraca bieżący status subskrypcji, zanim klient wyśle dane
Wspólny potok: identyczne przechowywanie i przekazywanie na serwer klienta jak w natywnych silnikach
Spójny kontrakt błędów JSON dla brakującego numeru seryjnego, nieznanego urządzenia, nieprawidłowego tokenu lub nieaktywnej subskrypcji
Za nginx, z limitami rozmiaru treści i ograniczaniem liczby żądań

Buduj z HTTP Attendance API

Weź klucz, przeczytaj dokumentację i wdrażaj. Nasz zespół pomoże przy pierwszej integracji.

Porozmawiaj z inżynierem WhatsApp

FAQ

Częste pytania

Co robi HTTP Attendance API?

To niezależne od urządzenia wejście, które przyjmuje rozpoznane odbicia obecności, heartbeaty i sprawdzenia subskrypcji, uwierzytelnia je po numerze seryjnym urządzenia i tokenie oraz kieruje do wspólnego potoku obecności Cams.

Jak uwierzytelniane są żądania?

Każde żądanie zawiera nagłówek numeru seryjnego urządzenia (sn) i nagłówek auth-token; oba muszą być prawidłowe. Endpointy biometryczne dodatkowo wymagają aktywnej subskrypcji obecności.

Czy obecność przez HTTP jest traktowana tak samo jak z urządzeń?

Tak. Odbicia trafiają do tego samego potoku, którego używają natywne silniki HTTP, TCP i MQTT, więc przechowywanie i dalsze przekazywanie są identyczne niezależnie od transportu.

Powiązane

Poznaj więcej z platformy

USŁUGA

Przeglądaj wszystkie produkty