Estudo de Caso: Um Dispositivo Enviando Registros de Ponto para Vários Servidores
O requisito
Um cliente tinha um único dispositivo biométrico, mas precisava que os dados de ponto fossem entregues a dois sistemas de software separados. Por exemplo, uma plataforma de RH interna e um fornecedor terceirizado de folha de pagamento, sem instalar um segundo dispositivo nem dividir o hardware entre os dois.
Por que o conceito de API dupla se encaixa
Normalmente, um dispositivo é vinculado a uma API e a uma URL de callback: cada registro é enviado para um único destino. O conceito de API dupla remove esse limite de um para um. Em vez de adicionar hardware, o cliente adquire uma licença de API adicional para o mesmo dispositivo físico. Cada API recebe sua própria URL de callback, e o dispositivo envia todos os registros de ponto para todas as URLs configuradas ao mesmo tempo, não em sequência, nem com atraso.
Isso significa que o cliente não precisou de dois dispositivos na porta, de dois processos de cadastro ou de dois conjuntos de manutenção de hardware. Um registro, um dispositivo, vários destinos.
Como o fluxo funciona
Fluxo de API dupla: um registro entregue simultaneamente a duas URLs de callback configuradas
- O usuário registra o ponto no dispositivo normalmente, sem nenhuma mudança na experiência do usuário final.
- O dispositivo possui duas (ou mais) APIs configuradas, cada uma apontando para sua própria URL de callback.
- O registro de ponto é enviado simultaneamente para todas as URLs configuradas.
- Cada servidor/software receptor processa o registro de forma independente, sem depender da resposta do outro.
Escalando além de dois
Isso não se limita a dois destinos. O mesmo conceito se estende a n APIs em um único dispositivo, sendo que cada API adicional é outra API sombra com sua própria URL de callback, e o dispositivo envia para todas elas ao mesmo tempo. Um cliente que sincroniza o ponto com RH, folha de pagamento e um painel de conformidade, por exemplo, poderia configurar três APIs em um único dispositivo, em vez de operar três leitores separados.
O que envolve a compra
|
Primeira API no dispositivo
|
Cada API adicional (sombra)
O custo do dispositivo não se aplica, pois você está reutilizando a unidade existente. |
Observações de implementação
- Cada par API/URL de callback opera de forma independente: uma falha ou resposta lenta em uma URL de callback não bloqueia nem atrasa a entrega para as demais.
- Como a entrega é simultânea, e não um servidor repassando para o seguinte, não há cadeia de dependência a gerenciar entre os sistemas receptores.
- Isso funciona bem quando dois sistemas precisam dos mesmos dados brutos de ponto para finalidades diferentes (por exemplo, folha de pagamento versus registro de acesso), em vez de precisarem se comunicar entre si.
- Cada API e sua URL de callback são configuradas de forma independente pelo painel; adicionar uma API sombra não exige nenhuma reconfiguração no próprio dispositivo.
- Use o API Monitor para verificar a entrega para cada API sombra separadamente, pois um problema de entrega em uma URL de callback não necessariamente aparecerá em outra.
- Como os destinos são totalmente desacoplados, a API dupla também é uma forma limpa de executar uma migração em paralelo: mantenha o sistema atual recebendo dados enquanto um novo sistema é validado e, depois de confiar na troca, desative a URL de callback antiga.
Resultado
O cliente atendeu ao requisito de dois destinos usando seu dispositivo único já existente, evitando o custo e a complexidade de uma segunda unidade. A configuração exigiu apenas a licença de API incremental para o segundo destino, sendo o custo do dispositivo cobrado uma única vez.