Connecter vos appareils de pointage à Mawered : le guide par type d'appareil
Terminaux biométriques, systèmes de contrôle d'accès ou tout appareil via l'API ouverte : comment chaque type d'appareil envoie ses pointages à Mawered, et ce que l'API attend.
Co-fondateur & CTO, Mawered
Amine conçoit l'architecture SIRH multi-pays de Mawered depuis sa création. Il est spécialisé dans l'intégration des systèmes biométriques et les moteurs de paie réglementaires.
Mawered fonctionne avec vos appareils de pointage : terminaux biométriques, systèmes de contrôle d'accès et tout appareil via l'API ouverte. Vous n'avez pas à changer de matériel, ni à choisir une seule marque pour tous vos sites. Ce guide présente, type d'appareil par type d'appareil, comment les pointages arrivent dans Mawered et ce que vous avez à configurer.
Vue d'ensemble : trois façons de connecter un appareil
| Type d'appareil | Comment les pointages arrivent | Ce que vous configurez |
|---|---|---|
| Terminaux ZKTeco (mode pointage ou contrôle d'accès) | Le terminal envoie lui-même ses pointages à l'adresse de votre espace Mawered. | Le terminal dans Mawered, puis l'adresse du serveur sur le terminal. |
| Autres terminaux biométriques et systèmes de contrôle d'accès | Le logiciel du fabricant ou un partenaire d'intégration transmet les pointages à l'API webhook ouverte de Mawered. | Une source webhook dans Mawered et sa clé API, puis l'envoi côté logiciel ou partenaire. |
| Logiciel de pointage, middleware ou autre SIRH | Le logiciel appelle directement l'API webhook ouverte. | Une source webhook et sa clé API. |
Quel que soit le chemin, chaque pointage est rattaché à l'employé par son numéro matricule, puis alimente les présences journalières, le planning et la paie de la même façon.
1. Terminaux ZKTeco
Les terminaux ZKTeco compatibles avec le protocole ADMS envoient leurs pointages directement à l'adresse de votre espace Mawered (votre sous-domaine). Le pas-à-pas complet, des prérequis au dépannage, est dans le guide d'intégration ZKTeco. Deux modes de fonctionnement sont acceptés, côte à côte dans la même société :
Mode pointage
Le terminal fonctionne comme une pointeuse : l'employé s'identifie (empreinte, visage, badge ou code) et le terminal enregistre une entrée ou une sortie. Chaque pointage arrive dans Mawered avec son sens.
Mode contrôle d'accès
Le terminal commande une porte. Mawered retient uniquement les accès autorisés d'un employé identifié et en fait des pointages :
- Un accès autorisé n'a pas de sens entrée/sortie : le premier pointage de la journée sert d'entrée, le dernier de sortie.
- Les accès refusés, les états de porte et les alarmes ne créent aucun pointage.
- Un même employé qui repasse sur le même terminal moins de 60 secondes après son dernier pointage ne crée pas de nouveau pointage.
Dans Mawered, le mode de chaque terminal est visible dans Appareils → Gestion (https://<votre-sous-domaine>.mawered.com/devices), à côté de son fabricant.
2. Autres terminaux biométriques et systèmes de contrôle d'accès
Les autres appareils se connectent via l'API webhook ouverte de Mawered. La plupart des fabricants proposent un moyen de récupérer les événements de leurs appareils : un logiciel de gestion ou de contrôle d'accès avec une API, une plateforme cloud, ou l'envoi HTTP d'événements depuis l'appareil lui-même. Le logiciel du fabricant, ou un partenaire d'intégration, lit ces événements et les transmet à Mawered dans le format décrit plus bas.
Parmi les marques que vous pouvez connecter à Mawered : ZKTeco, Hikvision, Suprema, Anviz, Matrix COSEC, Dahua, Paxton, Nedap et TimeTec. Les autres systèmes se connectent via l'API ouverte de Mawered.
Pour démarrer, rassemblez trois informations : le logiciel ou la plateforme que vous utilisez avec vos appareils, la personne ou le partenaire qui peut y configurer un envoi HTTPS, et la liste des matricules de vos employés tels qu'ils sont enregistrés sur les appareils.
3. Créer une source webhook dans Mawered
Ces réglages sont réservés aux utilisateurs qui ont la permission Configurer les terminaux (terminals:configure).
- Dans Appareils → Gestion (https://<votre-sous-domaine>.mawered.com/devices), activez l'interrupteur Sources webhook. Tant qu'il est désactivé pour votre société, l'API répond 403 et n'enregistre rien.
- Cliquez sur Ajouter une source webhook, donnez-lui un nom (ex : "Passerelle contrôle d'accès - Siège") et choisissez son site.
- Mawered affiche la clé API de la source une seule fois. Copiez-la et transmettez-la à la personne qui configure l'envoi.
Chaque source a sa propre clé. Vous pouvez la renouveler ou la révoquer à tout moment depuis la fiche de la source : l'ancienne clé cesse alors de fonctionner immédiatement.
4. Ce que l'API attend
Les pointages sont envoyés en HTTPS, par lots, à l'adresse suivante :
POST https://votre-sous-domaine.mawered.com/api/v1/devices/punches/
Authorization: Bearer <clé API de la source>
Content-Type: application/json
{
"punches": [
{ "event_id": "evt-0001", "user_id": "1042", "timestamp": "2026-11-14T08:00:00+01:00", "direction": "in" },
{ "event_id": "evt-0002", "user_id": "1042", "timestamp": "2026-11-14T17:00:00+01:00", "direction": "out", "verification_mode": "face" }
]
}
- Une clé par source : la clé identifie la source et votre société. Une clé absente, erronée ou révoquée reçoit une réponse 401 ; si les sources webhook sont désactivées, la réponse est 403 et rien n'est enregistré.
- event_id : un identifiant unique du pointage dans la source. Renvoyer le même event_id ne crée pas de doublon : Mawered répond que le pointage a déjà été reçu. Vous pouvez donc renvoyer un lot sans risque après une coupure réseau.
- user_id : le numéro matricule de l'employé dans Mawered, en chaîne de caractères ou en nombre entier.
- timestamp : la date et l'heure au format ISO 8601 avec son décalage horaire (par exemple
+01:00ouZpour UTC). Un horodatage sans décalage est refusé. - direction :
inpour une entrée,outpour une sortie. verification_mode (empreinte, visage, badge…) est facultatif. - Limites : de 1 à 500 pointages par requête, un corps de requête de 2 Mio au plus (au-delà, réponse 413 et rien n'est enregistré), et environ 60 requêtes par minute et par clé. Sur une réponse 429, attendez toujours la durée indiquée par l'en-tête
Retry-Afterau lieu de compter vous-même vos requêtes. Un lot contenant un pointage invalide est refusé en entier (réponse 422 indiquant les pointages en cause). - Envois simultanés : si le même event_id est envoyé deux fois en même temps, l'un des envois peut recevoir une réponse 503 avec un en-tête
Retry-After; renvoyez alors le lot, sans risque de doublon.
La réponse liste, pour chaque event_id, ce qui a été fait : stored (pointage enregistré), duplicate (doublon d'un pointage déjà présent pour le même employé à la même heure) ou already_received (event_id déjà reçu ; original_outcome donne alors le résultat du premier envoi) :
{
"results": [
{ "event_id": "evt-0001", "outcome": "stored" },
{ "event_id": "evt-0002", "outcome": "already_received", "original_outcome": "stored" }
]
}
Fuseau horaire
Mawered convertit chaque horodatage et l'enregistre à l'heure locale du terminal (le fuseau défini sur la source), à défaut dans le fuseau horaire configuré pour la société du site, et à défaut en UTC. Les administrateurs doivent donc renseigner le fuseau horaire de la société.
Les pointages enregistrés apparaissent dans Pointages (https://<votre-sous-domaine>.mawered.com/pointages) et dans le monitoring des appareils comme ceux des autres terminaux.
Bonnes pratiques
- Vérifiez les matricules avant de connecter un appareil. Un matricule stocké "042" sur l'appareil et "42" dans Mawered ne sera pas rattaché au bon employé.
- Une source par système. Créez une source webhook distincte pour chaque logiciel ou site qui envoie des pointages : vous pourrez révoquer une clé sans couper les autres.
- Envoyez l'heure réelle du pointage, pas l'heure de l'envoi, avec son décalage horaire : c'est elle qui sert au calcul des retards et des heures travaillées.
Voir aussi : Guide d'intégration ZKTeco — Gestion des absences et pointage biométrique pour les PME — Module de gestion des pointages (https://<votre-sous-domaine>.mawered.com/pointages)
Prêt à automatiser vos RH ?
Mawered est conçu pour les entreprises de la région MENA. Calcul de paie conforme, pointage depuis vos terminaux biométriques, systèmes de contrôle d'accès ou tout appareil via l'API ouverte, gestion des absences et du planning dans un seul outil.
Demander une démonstration gratuite