Ir al contenido
Fusehub
Vídeo

Consultar entradas y salidas

POST
/api/integration/v1/sites/{site_id}/devices/{device_id}/people-counting/search

Devuelve cuántas personas entraron y salieron frente a una cámara en un rango de horas. Solo cuenta, no identifica a nadie.

Las horas van en la hora local de la cámara. El resultado viene por periodos (horas, días, meses o años) y los totales suman los periodos completos que tocan el rango: si pides de 07:00 a 07:20 por horas, recibes el conteo de 07:00 a 07:59.

Autenticación

IntegrationKey
headerX-Integration-Key<token>

Tu clave de integración. Se crea en la consola de Fusehub, en Herramientas de desarrollo → API Keys.

site_id*Site Id

Código de la sede.

device_id*Device Id

Código de la cámara en Fusehub o su número de serie.

application/json
  1. body

Rango de horas a consultar.

startTime*Starttime

Inicio, en hora local de la cámara (YYYY-MM-DDTHH:MM:SS).

Largo1 <= length
endTime*Endtime

Fin, en hora local de la cámara (YYYY-MM-DDTHH:MM:SS).

Largo1 <= length
channel?|

Canal de video. Si no se envía, se usa el de la cámara.

reportType?|

Cómo agrupar el resultado: daily por hora (por defecto), weekly por día, monthly por mes, yearly por año.

Por defecto"daily"

Cuerpo de la respuesta

OK

application/json
  1. response
ok?Ok
Por defectotrue
deviceId*Deviceid

Código de la cámara en Fusehub.

channel*Channel

Canal de video usado.

reportType*Reporttype

Agrupación usada.

startTime*Starttime

Inicio pedido, en hora local de la cámara.

endTime*Endtime

Fin pedido, en hora local de la cámara.

enter*Enter

Total de entradas.

exit*Exit

Total de salidas.

occupancy*Occupancy

Entradas menos salidas. Puede ser negativo.

total*Total

Entradas más salidas.

buckets*array<>

Detalle por periodo.

Ejemplo de petición
curl -X POST 'https://api.fusehub.lat/api/integration/v1/sites/string/devices/00000000-0000-4000-8000-000000000163/people-counting/search' \  -H 'Content-Type: application/json' \  -d '{  "startTime": "2026-09-15T07:00:00",  "endTime": "2026-09-15T07:20:00"}'
Ejemplo de respuesta
{  "ok": true,  "deviceId": "00000000-0000-4000-8000-000000000163",  "channel": 1,  "reportType": "daily",  "startTime": "2026-09-15T07:00:00",  "endTime": "2026-09-15T07:20:00",  "enter": 4,  "exit": 2,  "occupancy": 2,  "total": 6,  "buckets": [    {      "startTime": "2026-09-15T07:00:00",      "endTime": "2026-09-15T07:59:59",      "enter": 4,      "exit": 2,      "occupancy": 2,      "total": 6    }  ]}