Primeros pasos

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de PunchConnect (regístrate)
• Un dispositivo biométrico con protocolo ZKTeco
• El número de serie de tu dispositivo

Cómo funciona

PunchConnect es una REST API. Interactúas con ella usando solicitudes HTTP — sin SDK requerido. Usa Postman, cURL o cualquier cliente HTTP en el lenguaje de tu preferencia (PHP, Python, Node.js, etc.).

Lista tus dispositivos

Una vez que tus dispositivos estén registrados a través del panel, usa la API para listarlos y comenzar a interactuar.

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"

Autenticación

Todas las solicitudes a la API se autentican usando dos encabezados: tu client ID y client secret. Obtenlos desde el panel de PunchConnect.

Códigos de error

PunchConnect usa códigos de estado HTTP estándar. Todos los errores devuelven un cuerpo JSON consistente.

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