HTTP Attendance API

Overzicht

Een apparaatonafhankelijke HTTPS-voordeur voor het opnemen van aanwezigheidspunches, heartbeats en abonnementscontroles van elke client.

De HTTP Attendance API is de apparaatonafhankelijke voordeur op het pad /api/attendance/v1/{op}. Hij authenticeert elk verzoek via de headers voor apparaatserienummer (sn) en auth-token en neemt het daarna op. Hij biedt punch (één herkend aanwezigheidsevent), heartbeat (aanwezigheid van het apparaat), validity (abonnementscontrole) en config. Punches stromen naar de gedeelde pipeline, met identieke opslag en downstream-push naar klantservers als bij de native HTTP-, TCP- en MQTT-transporten — zodat integraties consistent blijven, ongeacht hoe aanwezigheid binnenkomt.

APIRESTHTTPSJSONC++

Gebruikt in:Scholen, hogescholen en campus

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}

Mogelijkheden

Wat het doet

Een punch opnemen

POST één herkend aanwezigheidsevent met gebruiker, tijdstempel, IN-/UIT-status, invoertype en optionele locatie.

Aanwezigheid melden

Stuur een heartbeat om een apparaat als online te markeren, zonder body.

Geldigheid controleren

Vraag op of het aanwezigheidsabonnement van het apparaat actief is voordat u data verstuurt.

Uniforme pipeline

Elke punch komt terecht in hetzelfde opslag- en pushpad als bij native TCP- en MQTT-ingest.

Functies

Alles inbegrepen

Eén HTTPS-ingang voor edge-, app-, web- en hybride clients op /api/attendance/v1/{op}
Authenticatie via headers: apparaatserienummer (sn) plus auth-token, met abonnementscontrole
punch-endpoint neemt een herkend aanwezigheidsevent op (gebruiker, tijd, IN/UIT, invoertype, optionele geolocatie)
heartbeat-endpoint markeert een apparaat als online voor aanwezigheidsregistratie
validity-endpoint geeft de live abonnementsstatus terug voordat een client data verstuurt
Gedeelde pipeline: identieke opslag en push naar de klantserver als bij de native engines
Consistent JSON-foutcontract voor ontbrekend serienummer, onbekend apparaat, ongeldig token of inactief abonnement
Met nginx ervoor, met limieten op bodygrootte en rate limiting

Bouw met HTTP Attendance API

Haal een sleutel op, lees de docs en ga live. Ons team helpt u bij uw eerste integratie.

Praat met een engineer WhatsApp

FAQ

Veelgestelde vragen

Wat doet de HTTP Attendance API?

Het is de apparaatonafhankelijke voordeur die herkende aanwezigheidspunches, heartbeats en abonnementscontroles accepteert, ze authenticeert op apparaatserienummer en token en ze doorvoert naar de gedeelde Cams-aanwezigheidspipeline.

Hoe worden verzoeken geauthenticeerd?

Elk verzoek bevat een header met apparaatserienummer (sn) en een auth-token-header; beide moeten geldig zijn. Biometrische endpoints vereisen daarnaast een actief aanwezigheidsabonnement.

Wordt aanwezigheid via HTTP hetzelfde behandeld als van apparaten?

Ja. Punches stromen naar dezelfde pipeline als die van de native HTTP-, TCP- en MQTT-engines, dus opslag en downstream-push zijn identiek, ongeacht het transport.

Gerelateerd

Ontdek meer van het platform

SERVICE

Alle producten bekijken