HTTP-Anwesenheits-API

Der zentrale HTTPS-Eingang für jeden Client, der Anwesenheit erzeugt. Die HTTP-Anwesenheits-API authentifiziert per Geräte-Seriennummer und Token und leitet dann jede erkannte Stempelung in dieselbe Speicher- und Kunden-Push-Pipeline wie bei jeder nativen Cams Engine.

Loslegen Entwicklerdokumentation

Überblick

Ein geräteunabhängiger HTTPS-Zugang zur Aufnahme von Anwesenheitsstempelungen, Heartbeats und Abonnementprüfungen von jedem Client.

Die HTTP-Anwesenheits-API ist der geräteunabhängige Zugang unter dem Pfad /api/attendance/v1/{op}. Sie authentifiziert jede Anfrage über die Header für Geräte-Seriennummer (sn) und Auth-Token und nimmt die Daten dann auf. Sie stellt punch (ein erkanntes Anwesenheitsereignis), heartbeat (Geräteanwesenheit), validity (Abonnementprüfung) und config bereit. Stempelungen laufen in die gemeinsame Pipeline und erhalten so identische Speicherung und denselben nachgelagerten Push zum Kundenserver wie bei den nativen HTTP-, TCP- und MQTT-Transporten – Integrationen bleiben also konsistent, egal wie die Anwesenheit eintrifft.

APIRESTHTTPSJSONC++

Im Einsatz bei:Schulen, Hochschulen & 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}

Funktionen

Was er kann

Eine Stempelung aufnehmen

Ein erkanntes Anwesenheitsereignis per POST senden, mit Benutzer, Zeitstempel, IN/OUT-Status, Eingabetyp und optionalem Standort.

Anwesenheit melden

Einen Heartbeat senden, um ein Gerät ohne Body als online zu markieren.

Gültigkeit prüfen

Abfragen, ob das Anwesenheitsabonnement des Geräts aktiv ist, bevor Daten gesendet werden.

Einheitliche Pipeline

Jede Stempelung landet im selben Speicher- und Push-Pfad wie die nativen TCP- und MQTT-Eingänge.

Merkmale

Alles inklusive

Ein einziger HTTPS-Eingang für Edge-, App-, Web- und Hybrid-Clients unter /api/attendance/v1/{op}
Header-basierte Authentifizierung: Geräte-Seriennummer (sn) plus Auth-Token, mit Abonnementprüfung
Der punch-Endpoint nimmt ein erkanntes Anwesenheitsereignis auf (Benutzer, Zeit, IN/OUT, Eingabetyp, optionale Geolokalisierung)
Der heartbeat-Endpoint markiert ein Gerät für die Präsenzverfolgung als online
Der validity-Endpoint liefert den aktuellen Abonnementstatus, bevor ein Client Daten sendet
Gemeinsame Pipeline: identische Speicherung und identischer Push zum Kundenserver wie bei den nativen Engines
Einheitlicher JSON-Fehlervertrag bei fehlender Seriennummer, unbekanntem Gerät, ungültigem Token oder inaktivem Abonnement
Mit nginx vorgeschaltet, mit Begrenzung der Body-Größe und Ratenbegrenzung

Mit der HTTP-Anwesenheits-API entwickeln

Schlüssel holen, Dokumentation lesen und live gehen. Unser Team unterstützt Sie bei Ihrer ersten Integration.

Mit einem Ingenieur sprechen WhatsApp

FAQ

Häufige Fragen

Was macht die HTTP-Anwesenheits-API?

Sie ist der geräteunabhängige Zugang, der erkannte Anwesenheitsstempelungen, Heartbeats und Abonnementprüfungen entgegennimmt, sie per Geräte-Seriennummer und Token authentifiziert und in die gemeinsame Cams Anwesenheits-Pipeline einspeist.

Wie werden Anfragen authentifiziert?

Jede Anfrage enthält einen Header mit der Geräte-Seriennummer (sn) und einen Auth-Token-Header; beide müssen gültig sein. Biometrische Endpoints erfordern zusätzlich ein aktives Anwesenheitsabonnement.

Wird Anwesenheit über HTTP genauso behandelt wie die von Geräten?

Ja. Stempelungen laufen in dieselbe Pipeline, die auch die nativen HTTP-, TCP- und MQTT-Engines nutzen, sodass Speicherung und nachgelagerter Push unabhängig vom Transport identisch sind.