Como testar um terminal ZKTeco sem comprar hardware: sandbox virtual passo a passo

O custo real de "testar com um equipamento real"

Se você desenvolve um SaaS de folha de pagamento, um sistema de condomínios ou uma plataforma de RH, em algum momento um cliente vai perguntar: "você consegue ler meus terminais ZKTeco?". O caminho tradicional é assim:

• Comprar um terminal de teste: entre $250 e $900 USD conforme o modelo.
• Logística de importação na América Latina: semanas de espera e tributos variáveis.
• Montar um servidor local ou uma VPN só para os primeiros testes.
• Dedicar tempo do seu time antes de saber se a funcionalidade vale a pena.

Ou seja: centenas de dólares e semanas de atrito antes da primeira linha de integração. Para um time de produto, isso costuma significar que a funcionalidade nunca sai do backlog.

O que você pode validar sem tocar no hardware

O sandbox da API Connect cria até 2 terminais virtuais com as mesmas capacidades de um terminal físico conectado à nuvem:

• Registro de terminais com número de série, modelo e data de expiração.
• Eventos de acesso em tempo real: marcações concedidas, negadas e pulsos de sincronização.
• Relatórios de ponto consultáveis por faixa de datas, com paginação.
• Usuários e credenciais: cadastro de pessoas com PIN, cartão e grupos de acesso.
• Expiração de dispositivos: teste como se comporta a sua lógica quando um terminal vence.

Passo a passo: do zero ao seu primeiro evento

1. Crie sua conta (14 dias grátis, sem cartão)

O cadastro leva menos de um minuto. Ao entrar no dashboard você tem acesso ao sandbox, à API e aos relatórios durante todo o teste.

2. Crie seu primeiro terminal virtual

Pelo sandbox do dashboard, crie um terminal virtual. Você receberá o número de série simulado, que é a chave para todo o resto.

3. Simule marcações pelo navegador

A tela de simulação permite interagir com o terminal virtual: registrar marcações de entrada e saída, e gerar eventos de acesso. Cada evento fica no seu histórico como se viesse de um equipamento físico.

4. Autentique seu software na API

Seu backend se autentica com as credenciais da sua conta e recebe um token para chamar a API REST:

curl -X POST https://SEU-DOMINIO-API/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "seu_usuario", "password": "sua_senha"}'

# Resposta
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "token_type": "bearer",
  "expires_in": 3600
}

5. Consulte as marcações geradas

Com o token, peça o relatório do terminal virtual com a faixa de datas que quiser:

curl -X GET "https://SEU-DOMINIO-API/report/SEU-SERIAL?from=2026-09-01&to=2026-09-14&page=1&per_page=500" \
  -H "Authorization: Bearer {token}"

A resposta chega em JSON pronta para mapear aos seus modelos: marcação, pessoa, método de verificação e data exata. Se o seu software já importa CSVs de relógios de ponto, este passo é a diferença entre um processo manual semanal e dados ao vivo.

6. (Opcional) Consuma os eventos como stream

Se a sua arquitetura prefere reagir a eventos em vez de consultá-los, você pode assinar os eventos do terminal e processá-los conforme ocorrem:

import { createClient } from 'redis';

const sub = createClient({
  socket: { host: process.env.REDIS_HOST, port: Number(process.env.REDIS_PORT) },
  password: process.env.REDIS_PASSWORD
});

await sub.connect();

await sub.subscribe('punch_SEU-SERIAL', (message) => {
  const event = JSON.parse(message);
  console.log('nova marcação:', event.pin, event.timestamp);
  // aqui dispara a sua lógica de negócio
});

Quando passar para produção

No dia em que a funcionalidade for aprovada, a transição é a parte fácil: os terminais físicos do cliente são registrados e apontados para a nuvem, e seu software continua chamando as mesmas URLs. Não há fase de "reescrita" porque sandbox e produção compartilham a mesma API.

O valor para o seu produto, em uma frase

Você pode responder "sim, lemos seus terminais ZKTeco" em uma demo com dados reais no mesmo dia em que a oportunidade comercial surge — sem comprar nada, sem esperar importações e sem montar infraestrutura.

Perguntas frequentes