API de présence HTTP

L'unique point d'entrée HTTPS pour tout client qui produit de la présence. L'API de présence HTTP authentifie par numéro de série et token d'appareil, puis achemine chaque pointage reconnu vers le même pipeline de stockage et d'envoi aux clients que tous les moteurs Cams natifs.

Prise en main Documentation développeurs

Présentation

Une porte d'entrée HTTPS indépendante des appareils pour ingérer les pointages, les signaux de présence (heartbeats) et les vérifications d'abonnement de n'importe quel client.

L'API de présence HTTP est la porte d'entrée indépendante des appareils, sur le chemin /api/attendance/v1/{op}. Elle authentifie chaque requête par les en-têtes de numéro de série d'appareil (sn) et d'auth-token, puis ingère les données. Elle expose punch (un événement de présence reconnu), heartbeat (présence de l'appareil), validity (vérification d'abonnement) et config. Les pointages sont acheminés vers le pipeline partagé, avec un stockage et un envoi vers le serveur client identiques à ceux des transports natifs HTTP, TCP et MQTT — les intégrations restent ainsi cohérentes quelle que soit la façon dont la présence arrive.

APIRESTHTTPSJSONC++

Utilisé dans :Écoles, universités et 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}

Fonctionnalités

Ce qu'il fait

Ingérer un pointage

Envoyez en POST un événement de présence reconnu, avec l'utilisateur, l'horodatage, l'état IN/OUT, le type d'entrée et, en option, la localisation.

Signaler la présence

Envoyez un heartbeat pour marquer un appareil comme en ligne, sans aucun corps de requête.

Vérifier la validité

Vérifiez si l'abonnement de présence de l'appareil est actif avant d'envoyer des données.

Pipeline unifié

Chaque pointage arrive dans le même chemin de stockage et d'envoi que l'ingestion native TCP et MQTT.

Caractéristiques

Tout est inclus

Point d'entrée HTTPS unique pour les clients edge, applicatifs, web et hybrides sur /api/attendance/v1/{op}
Authentification par en-têtes : numéro de série de l'appareil (sn) plus auth-token, avec contrôle d'abonnement
L'endpoint punch ingère un événement de présence reconnu (utilisateur, heure, IN/OUT, type d'entrée, géolocalisation optionnelle)
L'endpoint heartbeat marque un appareil comme en ligne pour le suivi de présence
L'endpoint validity renvoie l'état d'abonnement en direct avant qu'un client n'envoie des données
Pipeline partagé : stockage et envoi vers le serveur client identiques à ceux des moteurs natifs
Contrat d'erreurs JSON cohérent pour un numéro de série manquant, un appareil inconnu, un token invalide ou un abonnement inactif
Placée derrière nginx, avec plafonds de taille de corps et limitation de débit

Développez avec l'API de présence HTTP

Obtenez une clé, lisez la documentation et livrez. Notre équipe vous accompagne pour votre première intégration.

Parler à un ingénieur WhatsApp

FAQ

Questions fréquentes

Que fait l'API de présence HTTP ?

C'est la porte d'entrée indépendante des appareils qui accepte les pointages reconnus, les heartbeats et les vérifications d'abonnement, les authentifie par numéro de série et token d'appareil, et les injecte dans le pipeline de présence Cams partagé.

Comment les requêtes sont-elles authentifiées ?

Chaque requête transporte un en-tête de numéro de série d'appareil (sn) et un en-tête d'auth-token ; les deux doivent être valides. Les endpoints biométriques exigent en outre un abonnement de présence actif.

La présence reçue par HTTP est-elle traitée comme celle des appareils ?

Oui. Les pointages sont acheminés vers le même pipeline que celui des moteurs natifs HTTP, TCP et MQTT : le stockage et l'envoi en aval sont donc identiques, quel que soit le transport.