Plantonizei

App do médico › Biometria e documentos

Sortear o desafio de vida

POST/api/v1/me/biometrics/challengePede sessão

Como 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
}