Controle de Acesso - Liberação Manual

Descrição

Este endpoint registra uma liberação manual de acesso no sistema de controle de acesso. Ele é utilizado quando é necessário autorizar manualmente a entrada ou saída de uma pessoa em uma catraca/dispositivo, geralmente por intervenção de um colaborador ou administrador, sem passar pelas validações automáticas de acesso.

📨 Parâmetros da Requisição (Request Body)

O registro inclui o dispositivo utilizado, o motivo da liberação e informações sobre a pessoa.

Campo	Tipo	Obrigatório	Descrição
idTurnstile	int32	Sim	Identificador da catraca ou dispositivo de acesso onde a liberação foi registrada.
reason	string	Sim	Motivo da liberação manual (ex.: “Falha no leitor biométrico”, “Entrada autorizada pelo gerente”).
id	int32	Sim	Identificador da pessoa (aluno, prospect ou visitante) que está sendo liberada.
personType	int32	Sim	Tipo da pessoa (ex.: 1 = Aluno, 2 = Prospect, 3 = Funcionário, 4 = Personal).
idEmployAuthorization	int32	Sim	ID do funcionário ou colaborador que realizou a autorização manual.

📤 Estrutura da Resposta

A resposta retorna o registro criado da liberação manual, com o identificador gerado pelo sistema.

Campo	Tipo	Descrição
idManualLiberation	int32	Identificador do registro de liberação manual criado.

📝 Exemplo de Requisição

{
  "idTurnstile": 5,
  "reason": "Falha no leitor biométrico, entrada liberada manualmente",
  "id": 1025,
  "personType": 1,
  "idEmployAuthorization": 2001
}

✅ Exemplo de Resposta

{
  "idManualLiberation": 98765
}