Plantonizei

Painel da empresa › Ponto

Registrar entrada

POST/api/v1/checkins/inPede sessão

Como funciona

Registra a entrada do médico no plantão, pelo app. Grava de onde partiu a ação: o IP e os cabeçalhos opcionais do aparelho (X-Device-Id, X-Device-Platform, X-Device-Maker, X-Device-Model, X-Device-Os, X-Device-Physical, X-Device-Locale, X-Device-Timezone, X-Device-Screen e X-App-Version).

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 latitude e longitude: 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 em framesMs e o código do desafio de vida em challenge. O que o app declarar em biometry nã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 422 BIOMETRIA_EXIGIDA.

Quando a entrada precisa de validação (fora do raio, rosto que não conferiu, atraso), quem acompanha a escala recebe o aviso "Check-in para validar" com o motivo.

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