HTTP Attendance API

Огляд

Незалежний від пристроїв HTTPS-вхід для приймання відміток відвідуваності, heartbeat-сигналів і перевірок підписки від будь-якого клієнта.

HTTP Attendance API — це незалежний від пристроїв вхід за шляхом /api/attendance/v1/{op}. Він автентифікує кожен запит за заголовками серійного номера пристрою (sn) та auth-token, а потім приймає дані. Він надає punch (одна розпізнана подія відвідуваності), heartbeat (присутність пристрою), validity (перевірка підписки) та config. Відмітки потрапляють у спільний конвеєр, що забезпечує однакове зберігання та подальше передавання на сервер клієнта, як і рідні транспорти HTTP, TCP і MQTT, — тож інтеграції залишаються узгодженими незалежно від того, як надходить відвідуваність.

APIRESTHTTPSJSONC++

Використовується в:Школи, коледжі та кампуси

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}

Можливості

Що він робить

Приймання відмітки

Надішліть через POST одну розпізнану подію відвідуваності з користувачем, часовою міткою, станом IN/OUT, типом вводу та необов’язковим розташуванням.

Повідомлення про присутність

Надішліть heartbeat, щоб позначити пристрій як онлайн, без жодного тіла запиту.

Перевірка дійсності

Запитайте, чи активна підписка пристрою на облік відвідуваності, перш ніж надсилати дані.

Єдиний конвеєр

Кожна відмітка потрапляє в той самий шлях зберігання та передавання, що й рідне приймання через TCP і MQTT.

Можливості

Усе включено

Єдиний HTTPS-вхід для edge-, застосункових, веб- і гібридних клієнтів за шляхом /api/attendance/v1/{op}
Автентифікація через заголовки: серійний номер пристрою (sn) плюс auth-token, із контролем підписки
Endpoint punch приймає розпізнану подію відвідуваності (користувач, час, IN/OUT, тип вводу, необов’язкова геолокація)
Endpoint heartbeat позначає пристрій як онлайн для відстеження присутності
Endpoint validity повертає поточний статус підписки до того, як клієнт надішле дані
Спільний конвеєр: те саме зберігання та передавання на сервер клієнта, що й у рідних рушіїв
Єдиний JSON-контракт помилок для відсутнього серійного номера, невідомого пристрою, недійсного токена чи неактивної підписки
Розміщено за nginx з обмеженнями розміру тіла запиту та лімітом частоти запитів

Створюйте з HTTP Attendance API

Візьміть ключ, прочитайте документацію й запускайте. Наша команда допоможе з першою інтеграцією.

Поговорити з інженером WhatsApp

Поширені запитання

Що робить HTTP Attendance API?

Це незалежний від пристроїв вхід, що приймає розпізнані відмітки відвідуваності, heartbeat і перевірки підписки, автентифікує їх за серійним номером пристрою та токеном і передає у спільний конвеєр відвідуваності Cams.

Як автентифікуються запити?

Кожен запит містить заголовок серійного номера пристрою (sn) та заголовок auth-token; обидва мають бути дійсними. Біометричні endpoint додатково вимагають активної підписки на облік відвідуваності.

Чи обробляється відвідуваність через HTTP так само, як із пристроїв?

Так. Відмітки потрапляють у той самий конвеєр, що й рідні рушії HTTP, TCP і MQTT, тож зберігання та подальше передавання однакові незалежно від транспорту.

Повʼязане

Дізнайтеся більше про платформу

СЕРВІС

Переглянути всі продукти