Démarrage

Prérequis

Avant de commencer, vous aurez besoin de :

• Un compte PunchConnect (inscription)
• Un appareil biométrique compatible ZKTeco
• Le numéro de série de votre appareil

Comment ça fonctionne

PunchConnect est une REST API. Vous interagissez avec elle via des requêtes HTTP — aucun SDK requis. Utilisez Postman, cURL ou tout client HTTP dans le langage de votre choix (PHP, Python, Node.js, etc.).

Lister vos appareils

Une fois vos appareils enregistrés via le tableau de bord, utilisez l'API pour les lister et commencer à interagir.

curl https://api.punchconnect.com/api/v2/zk/devices \
  -H "X-CLIENT-ID: your_client_id" \
  -H "X-CLIENT-SECRET: your_client_secret" \
  -H "Accept: application/json"

Authentification

Toutes les requêtes API sont authentifiées avec deux en-têtes : votre identifiant client et votre secret client. Obtenez-les depuis le tableau de bord PunchConnect.

Codes d'erreur

PunchConnect utilise les codes de statut HTTP standard. Toutes les erreurs renvoient un corps JSON cohérent.

{
  "error": {
    "code": "device_not_found",
    "message": "No device found with serial CZKT2024099",
    "status": 404
  }
}