ACS
Sincronizar persona a terminales
POST
Reintenta la sincronización de la persona hacia los Recos de su nivel o grupo. Útil tras sync.status partial o failed (p. ej. terminal offline). HTTP 200 con sync.status synced, partial, failed o skipped. No modifica vigencia ni foto.
IntegrationKeyheader
X-Integration-Key<token>Clave de integración (fhint_…). Consola Fusehub → Herramientas de desarrollo → API Keys.
site_id*Site IdUUID Fusehub de la sede.
external_person_id*External Person IdId externo de la persona (employeeNo en el terminal).
OK
application/json- response
ok?OkPor defecto
trueperson*deviceLinks?array<>accessLevels?array<>directAccessLevels?array<>groups?array<>accessStatus?|granted | denied | expired.
sync?|Presente tras provision, update o foto.
[key: string]?anycurl -X POST 'https://api.staging.fusehub.lat/api/integration/v1/sites/string/acs/persons/by-external/string/sync'Ejemplo de respuesta
{ "ok": true, "person": { "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" }, "deviceLinks": [], "accessLevels": [ { "id": "aa10c4d2-1e77-4b90-8c33-91f0a2b64d10", "name": "Visitantes", "kind": "permanent", "doorBindings": [ { "deviceId": "00000000-0000-4000-8000-000000000163", "doorNos": [ 1 ], "deviceSerial": "DS-K1T343-ABC", "serialNumber": "DS-K1T343-ABC", "shortSerial": "ABC" } ] } ], "directAccessLevels": [], "groups": [], "accessStatus": "granted", "sync": { "status": "synced", "applied": 1, "failed": 0, "results": [ { "deviceId": "00000000-0000-4000-8000-000000000163", "serial": "DS-K1T343-ABC", "deviceSerial": "DS-K1T343-ABC", "shortSerial": "ABC", "ok": true } ] }}