Painel da empresa › Ponto
Registrar saída
POST/api/v1/checkins/outPede sessãoComo funciona
Registra a saída do médico do plantão, pelo app. Só existe saída depois de uma entrada no mesmo plantão.
Quem bate é sempre o médico da sessão, no plantão dele (shiftId). Gestor não bate ponto por ninguém (403).
- O horário da batida é o do servidor. O app só pode mandar
at(RFC 3339) para um envio que ficou preso sem rede: até 12 horas para trás e nunca mais de 2 minutos à frente. - Mande
latitudeelongitude: a batida longe do local da escala não é recusada, mas fica para a coordenação validar. - Com a biometria ligada na empresa, o servidor confere o rosto: mande as fotos em
frames, os instantes emframesMse o código do desafio de vida emchallenge. O que o app declarar embiometrynão vale. Rosto que não confere não bloqueia a batida, mas manda o ponto para validação e pede ao médico uma foto nova. Se o serviço de biometria estiver fora, a batida também segue para validação: o médico nunca fica sem ponto por causa de um serviço externo. - Médico sem rosto cadastrado recebe 409
BIOMETRIA_SEM_CADASTRO. Empresa que exige a foto, sem foto no pedido, devolve 422BIOMETRIA_EXIGIDA.
Parâmetros
atCorpo · stringHorário da batida (RFC 3339), só para envio que ficou preso sem rede: até 12 horas para trás.biometryCorpo · stringResultado da biometria.challengeCorpo · stringCódigo do desafio de vida.deviceIdCorpo · stringIdentificador do aparelho que bateu o ponto.framesCorpo · string[]Fotos do rosto em JPEG, em base64, até 512 KB cada.framesMsCorpo · integer[]Instante de cada foto, em milissegundos, na mesma ordem de `frames`.diagnosticCorpo · stringO que o detector do aparelho mediu em cada quadro (gesto, giro, olhos, sorriso). Vai só ao log quando a prova de vida é recusada; nunca imagem.latitudeCorpo · numberLatitude.longitudeCorpo · numberLongitude.shiftIdCorpo · stringIdentificador do plantão.
Respostas
201 · id do registro de ponto.
idstring · Identificador do registro.
Corpo de exemplo
{
"id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e"
}