Ir al contenido
Fusehub
ACS

Listar personas

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

Listado de personas del directorio de la sede. Filtros opcionales por tipo de usuario (userType) y texto (q sobre nombre o id externo).

Autenticación

IntegrationKey
headerX-Integration-Key<token>

Clave de integración (fhint_…). Consola Fusehub → Herramientas de desarrollo → API Keys.

Parámetros de la ruta

site_id*Site Id

UUID Fusehub de la sede.

Parámetros de consulta

limit?Limit

Máximo de resultados por página (1–100).

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

Desplazamiento para paginación.

Rango0 <= value
Por defecto0
userType?|

Filtro por tipo: normal o visitor. Sin valor = todos.

q?|

Búsqueda parcial por nombre o externalPersonId.

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.staging.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.

Alta de persona POST

Crea una persona en la sede con vigencia, tipo de usuario, acceso y foto opcional. Body `multipart/form-data`: campos de texto + archivo `photo`. Acceso: exactamente uno de `accessGroupId`, `accessLevelId` o `deviceSerials`. Sincroniza a los terminales en el mismo llamado; `sync.status` es `synced`, `partial`, `failed` o `skipped`.