Tout appareil compatible HTTPS

Chronix Hub expose un seul point d’accès neutre vis-à-vis des fabricants. Votre appareil (ou le boîtier placé devant) envoie l’identifiant de l’appareil et l’identifiant qu’il vient de lire. Chronix Hub répond par une décision et un motif, et l’appareil n’ouvre que sur un oui explicite.

L’authentification est une clé d’appareil de type Bearer. Chaque clé appartient à un appareil et ne peut poser que des questions de contrôle d’accès : une clé divulguée ne permet pas de lire les données des membres.

• Plateformes et contrôleurs d’accès avec une étape de décision HTTP ou webhook.
• Middleware ou service sur mesure d’un intégrateur entre le lecteur et la serrure.
• Un petit script sur un PC ou un Raspberry Pi à côté du lecteur, avec un relais vers la serrure.
• Un terminal facial dont le middleware peut envoyer son propre identifiant pour la personne.
• Le matériel qui ne parle que son propre protocole n’est pas compatible HTTPS à lui seul. Voir les pages ZKTeco, Hikvision, Suprema et Kisi.

1. 1

   Créer la porte et l’horaire

   Onglet Portes : nommez la porte, choisissez un horaire et réglez l’anti-retour. Voir la présentation pour les détails.

2. 2

   Ajouter l’appareil

   Onglet Appareils, Ajouter un appareil. Nommez-le, choisissez le fabricant Autre (tout appareil capable d’appeler une API web), la porte. Ajoutez l’IP publique de la salle à la liste d’autorisation.

3. 3

   Copier la clé et l’identifiant de l’appareil

   La clé n’est affichée qu’une fois. Rangez-la dans le coffre de secrets de l’appareil, pas dans un document partagé. L’identifiant (ou son nom exact) figure dans chaque requête.

4. 4

   Faire envoyer un POST à chaque passage

   Envoyez la requête ci-dessous au point de vérification, avec la clé en jeton Bearer. N’ouvrez la porte que si la réponse est 200 avec granted: true.

5. 5

   Envoyer un signal de vie

   Facultatif : pingez le point de signal de vie environ une fois par minute pour que l’onglet Appareils affiche En ligne (entendu dans les 2 dernières minutes).

6. 6

   Tester avec une vraie carte

   Présentez la carte d’un membre et surveillez le journal en direct. Vous devriez voir la tentative et son motif en quelques secondes.

curl -X POST https://api.chronixhub.com/api/v1/access/verify   -H "Authorization: Bearer $CHRONIX_DEVICE_KEY"   -H "Content-Type: application/json"   -d '{
    "deviceId": "Front turnstile",
    "credential": { "type": "card", "value": "0012345678" }
  }'

HTTP 200
{
  "granted": true,
  "reason": "active_membership",
  "memberId": "clx...",
  "memberName": "Sara Haddad",
  "expiresAt": "2026-12-31T23:59:59.000Z",
  "displayMessage": "Welcome, Sara"
}

HTTP 200
{
  "granted": false,
  "reason": "membership_frozen",
  "displayMessage": "Membership is frozen"
}

Types d’identifiants

Envoyez exactement un identifiant par requête.

curl -X POST https://api.chronixhub.com/api/v1/access/heartbeat   -H "Authorization: Bearer $CHRONIX_DEVICE_KEY"   -H "Content-Type: application/json"   -d '{ "deviceId": "Front turnstile", "firmwareVersion": "1.4.2" }'

HTTP 200
{ "ok": true, "serverTime": "2026-10-21T08:30:00.000Z" }

// Open the door ONLY on an explicit yes. Everything else is "no".
const res = await fetch("https://api.chronixhub.com/api/v1/access/verify", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHRONIX_DEVICE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ deviceId, credential: { type, value } }),
});
const open = res.status === 200 && (await res.json()).granted === true;
if (open) unlockDoor();

Règles que votre intégration doit respecter

• Seul un HTTP 200 avec granted: true ouvre la porte. Traitez tout autre statut et tout délai dépassé comme un non.
• Chaque décision, refus compris, est un 200. Un statut non 200 signale un problème de requête ou de clé : 400, 401, 403, 404, 429 ou 5xx.
• Ne mettez jamais la clé dans une chaîne de requête ou une URL. Utilisez l’en-tête Authorization.
• Affichez displayMessage à l’écran de l’appareil s’il en a un. Il est court et sûr à afficher.
• Un PIN refusé n’inclut jamais de nom de membre : n’en attendez pas.
• Respectez le 429 en attendant avant de réessayer. La limite par défaut est de 60 tentatives par minute et par appareil.
• L’ouverture par défaut sert quand l’appareil ne peut pas joindre Chronix Hub du tout. Une erreur serveur n’est jamais une permission d’ouvrir.

• Le contrôleur ou le middleware peut-il émettre un POST HTTPS avec un jeton Bearer pour chaque tentative et ouvrir selon la réponse ?
• Peut-il envoyer un numéro de carte, un code tapé, l’identifiant d’un terminal facial et un QR scanné comme valeur d’identifiant ?
• Traitera-t-il toute erreur, tout délai dépassé et tout statut non 200 comme un refus ?
• Peut-il envoyer un signal de vie à peu près chaque minute ?
• Où sera stockée la clé de l’appareil, et qui peut la lire ?
• Quelle est l’IP publique de la salle, pour l’ajouter à la liste d’autorisation ?