App do médico › Biometria e documentos
Sortear o desafio de vida
POST/api/v1/me/biometrics/challengePede sessãoComo funciona
Sorteia o desafio de vida antes de uma captura do rosto. Mande o uso em purpose: ponto, antecipacao ou rosto (troca da foto).
A resposta traz o código do desafio (challenge), os passos que o app pede na ordem (steps: girar para um lado e quantos graus, piscar quantas vezes, sorrir) e até quando o código vale (expiresAt, no máximo 5 minutos). As fotos tiradas durante os passos e o código vão juntos no pedido do ponto, da antecipação ou da troca do rosto.
No ponto, se o serviço de biometria não responder, a resposta vem com unavailable: true e sem passos: a batida segue sem a conferência e fica para a coordenação validar. O médico nunca fica sem ponto por causa de um serviço externo.
Se os gestos não forem reconhecidos, o pedido do ponto, da antecipação ou da troca do rosto responde 422 DESAFIO_NAO_CUMPRIDO. Quando o serviço de biometria diz qual passo falhou, a mensagem nomeia o gesto (por exemplo, "não reconhecemos o gesto de sorrir"), para a pessoa saber o que repetir.
Médico sem rosto cadastrado recebe 409 BIOMETRIA_SEM_CADASTRO. Só a sessão de médico usa (403 para as outras).
Não funciona dentro de uma sessão de suporte (a equipe interna na conta do cliente).
Parâmetros
purposeCorpo · stringUso do desafio: `ponto`, `antecipacao` ou `rosto`.
Respostas
200 · challenge, steps e expiresAt, ou unavailable: true no ponto.
challengestring · Código do desafio de vida.expiresAtstring · Validade.stepsstring[] · Passos do desafio, na ordem.unavailableboolean · O serviço de biometria não respondeu; o ponto segue para validação.
Corpo de exemplo
{
"challenge": "texto",
"expiresAt": "texto",
"steps": [
"texto"
],
"unavailable": true
}