Ir al contenido
Fusehub
ACS

Listar personas

GET
/api/integration/v1/sites/{site_id}/acs/persons

Devuelve las personas registradas en la sede, por páginas. Se pueden filtrar por tipo y buscar por nombre o identificador.

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.

Parámetros de la ruta

site_id*Site Id

Código de la sede.

Parámetros de consulta

limit?Limit

Cantidad máxima de resultados (1 a 100).

Rango1 <= value <= 100
Por defecto50
offset?Offset

Cantidad de resultados a saltar, para paginar.

Rango0 <= value
Por defecto0
userType?|

Tipo de persona: normal (empleado) o visitor (visitante). Sin valor trae todas.

q?|

Texto a buscar en el nombre o el identificador.

Cuerpo de la respuesta

OK

application/json
  1. response
ok?Ok
Por defectotrue
persons*array<>
personCount*Personcount
limit?integer|null
offset?integer|null
faceImportJobId?string|null
Ejemplo de petición
curl -X GET 'https://api.fusehub.lat/api/integration/v1/sites/string/acs/persons'
Ejemplo de respuesta
{  "ok": true,  "persons": [    {      "id": "00000000-0000-4000-8000-000000000101",      "siteId": "00000000-0000-4000-8000-000000000044",      "externalPersonId": "invite-9001",      "name": "Invitado Demo",      "enabled": true,      "validFrom": "2026-10-06T09:00:00",      "validTo": "2026-10-06T18:00:00",      "userType": "visitor",      "maxOpenDoorTime": 3,      "accessStatus": "granted"    }  ],  "personCount": 1,  "limit": 50,  "offset": 0}

Resumen

Control de acceso con reconocimiento facial.

Crear persona POST

Registra una persona en la sede y la envía a los terminales en la misma llamada; `sync.status` en la respuesta dice si todos la recibieron. Se envía como `multipart/form-data`, con la foto como archivo opcional. Un empleado necesita un grupo; un visitante, un nivel de acceso o una lista de terminales, y siempre una fecha de fin.