Buscar Catracas

Descrição

Este endpoint retorna a lista de catracas/dispositivos de controle de acesso registrados no sistema. Ele permite filtrar os dispositivos por filial ou número de série, facilitando integrações e validações antes de realizar autorizações de entrada ou liberação manual.

🔑 Parâmetros da Requisição (Query Param)

Parâmetro	Tipo	Obrigatório	Descrição
serialNumber	string	Não	Número de série do dispositivo. Permite filtrar uma catraca específica.
idBranch	int32	Não	Identificador da filial. Útil em cenários com múltiplas filiais para limitar a consulta.

📤 Estrutura da Resposta

A resposta retorna uma lista de catracas cadastradas, com informações básicas sobre cada dispositivo.

Campo	Tipo	Descrição
name	string	Nome da catraca/dispositivo.
idTurnstile	int32	Identificador da catraca no sistema.
idBranch	int32	ID da filial a que a catraca pertence.
serialNumber	string	Número de série do dispositivo.

✅ Exemplo de Resposta

[
  {
    "name": "Catraca Entrada Principal",
    "idTurnstile": 1,
    "idBranch": 10,
    "serialNumber": "SN-123456"
  },
  {
    "name": "Catraca Saída",
    "idTurnstile": 2,
    "idBranch": 10,
    "serialNumber": "SN-654321"
  }
]