Início / Produtos / APIs / API REST de gerenciamento
API

API REST de gerenciamento

Controle programático da sua frota de dispositivos. A API REST de gerenciamento da Cams permite adicionar, cadastrar e excluir usuários, enviar templates de impressão digital e facial e fotos, controlar horários de acesso, ativar ou desativar usuários e consultar ou reenviar logs de frequência — tudo por um contrato REST estável e versionado.

Visão geral

Uma API REST versionada (V1/V2/V3) para gerenciar todo o ciclo de vida de dispositivos e usuários — provisionamento, comandos, templates, fotos, horários de acesso e logs de frequência.

A API REST de gerenciamento é a camada de comandos de gerenciamento de dispositivos da plataforma Cams, atendendo três versões de contrato (V1, V2, V3) lado a lado, com validação e processamento por versão. Ela cobre todo o ciclo de vida do usuário nos dispositivos de frequência Cams — adicionar usuário, adicionar template, adicionar foto, cadastrar, excluir, ativar ou desativar, atualizar horário de acesso, carregar e reenviar logs de batidas, reenviar usuários, reiniciar e inicializar — e encaminha os payloads de templates versionados ao tenant correto por meio do pareamento de dispositivos e do mapeamento de master-id. É a contrapartida operacional das APIs de ingestão em tempo real.

APIRESTHTTPSJSONC++

Feito para

Desenvolvedores e integradores de RH/folha de pagamento que gerenciam programaticamente usuários de dispositivos, templates biométricos e logs de frequência.

API REST biométricaAPI de gerenciamento de dispositivosAPI de dispositivos de frequênciaAPI de templates de impressão digitalAPI de cadastro de usuáriosAPI de logs de batidasAPI de horários de acessoAPI REST versionada

Recursos

O que ele faz

Gerenciar usuários

Adicione, cadastre, exclua e ative ou desative usuários nos dispositivos de forma programática.

Enviar templates e fotos

Envie templates de impressão digital ou facial e fotos de usuários aos dispositivos para correspondência no próprio dispositivo.

Consultar frequência

Carregue logs de batidas e reenvie registros de frequência sob demanda.

Contratos versionados

Atenda V1, V2 e V3 lado a lado para que os clientes migrem no seu próprio ritmo.

Operar dispositivos

Reinicie ou inicialize um dispositivo e envie ou reenvie a lista de usuários remotamente.

Funcionalidades

Tudo incluído

  • Três contratos de API versionados (V1, V2, V3) atendidos simultaneamente, com validação por versão
  • Ciclo de vida do usuário: adicionar, cadastrar, excluir, ativar ou desativar usuários de forma programática
  • Gerenciamento de dados biométricos: envio de templates de impressão digital e facial e fotos por usuário
  • Acesso à frequência: carregar logs de batidas e reenviar registros de frequência sob demanda
  • Controle de acesso: atualizar as janelas de horário de acesso por usuário
  • Controle de dispositivos: reiniciar e inicializar dispositivos remotamente
  • Interpretação de dados de templates versionados (R20, R30) com roteamento de tenant por pareamento de dispositivos e master-id
  • Envelope de comandos GET/PUT uniforme sobre um único modelo de operação e parâmetros

Crie com a API REST de gerenciamento

Pegue uma chave, leia a documentação e publique. Nossa equipe ajuda na sua primeira integração.

FAQ

Perguntas frequentes

O que a API REST de gerenciamento pode fazer?

Ela gerencia o ciclo de vida de usuários e dados biométricos nos dispositivos Cams: adicionar, cadastrar, excluir, ativar ou desativar usuários; enviar templates e fotos; definir horários de acesso; carregar e reenviar logs de batidas; enviar listas de usuários; e reiniciar ou inicializar dispositivos.

Quais versões da API são suportadas?

V1, V2 e V3 são atendidas simultaneamente, cada uma com sua própria camada de validação e processamento, para que os clientes migrem no seu próprio ritmo.

Há suporte a templates de impressão digital e facial?

Sim. Operações dedicadas enviam templates de impressão digital ou facial e fotos, para que as credenciais biométricas possam ser enviadas aos dispositivos de forma programática, inclusive payloads de templates R20 e R30 versionados.

Relacionados

Explore mais da plataforma