Cams Biometric Gateway — Web API 3.0
O Cams Biometric Gateway é a API biométrica universal que conecta qualquer equipamento biométrico de ponto ou controle de acesso à sua aplicação: ERP, HRMS, folha de pagamento, gestão escolar, software sob medida ou fluxo de trabalho de IA/automação. Ele é compatível com as principais marcas de equipamentos e oferece uma API biométrica JSON sobre HTTP padronizada, independentemente do hardware.
Como funciona
O Biometric Gateway é composto por:
Integra-se com
| Tipo de API | Direção | Latência | Caso de uso |
|---|---|---|---|
| API de callback | Equipamento → Seu servidor | Tempo real / latência zero | Receber marcações de ponto e eventos de sincronização de usuários |
| API RESTful | Seu servidor → Equipamento | ~15 segundos | Adicionar/excluir usuários, carregar registros, cadastrar biometrias |
Primeiros passos
Integre em três etapas. Seu servidor precisa de uma URL acessível publicamente para receber os callbacks.
Configure sua URL de callback
Faça login no portal API Monitor. Defina a URL HTTPS pública do seu servidor como URL de callback dos seus equipamentos. O motor da API enviará (POST) os eventos biométricos a esse endpoint em tempo real.
Receba as marcações de ponto
Seu endpoint recebe um POST com corpo JSON bruto; as APIs de callback não precisam de parâmetros de consulta. Valide o AuthToken, processe os dados da marcação e responda com {"status":"done"}.
Chame as APIs RESTful para gerenciar usuários e equipamentos
Envie (POST) um comando JSON para a URL do endpoint RESTful fornecida na sua conta do API Monitor, com o seu stgid (Service Tag ID) como parâmetro de consulta. O motor coloca o comando na fila e o equipamento o confirma em cerca de 15 segundos.
Formato do endpoint
| Tipo de API | Método | Como enviar |
|---|---|---|
| API de callback (entrada) | POST | O equipamento envia para a sua URL configurada. Corpo JSON bruto; sem parâmetros. |
| API RESTful (saída) | POST | Você envia (POST) para a URL do endpoint RESTful (disponível na sua conta do API Monitor) com ?stgid=YOUR_SERVICE_TAG_ID e um corpo JSON bruto. |
{"status":"done"} (HTTP 200) para confirmar o recebimento. Não faça processamento pesado antes de responder: coloque-o em fila.
Documentação da API
A referência está dividida por tópicos. Comece pela compatibilidade de equipamentos e depois siga para as operações de callback e REST.
Fale conosco
Para suporte da API, compatibilidade de equipamentos ou consultas comerciais:
Vendas e suporte
Recursos para desenvolvedores
Cams Biometrics (Dheeram Innovations Pvt Ltd) — No: 2/98D, 2nd Floor, Cams Biometrics Building, em frente à Satyabama University, Semmancheri, OMR, Chennai – 600119, Índia.