ACS
Subir o reemplazar foto
PUT
Actualiza la foto facial de la persona y la sincroniza a los terminales vinculados. Body multipart/form-data con el part photo (JPEG/PNG).
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).
multipart/form-data- body
photo*PhotoFoto JPEG/PNG.
OK
application/json- response
ok?OkPor defecto
trueface?|nulldeleted?boolean|nullsync?|null[key: string]?anycurl -X PUT 'https://api.staging.fusehub.lat/api/integration/v1/sites/string/acs/persons/by-external/string/photo' \ -F 'photo=string'Ejemplo de respuesta
{ "ok": true, "face": { "id": "00000000-0000-4000-8000-000000000201", "personId": "00000000-0000-4000-8000-000000000101", "siteId": "00000000-0000-4000-8000-000000000044", "deviceId": "00000000-0000-4000-8000-000000000163", "objectKey": "sites/00000000-0000-4000-8000-000000000044/acs/00000000-0000-4000-8000-000000000163/persons/00000000-0000-4000-8000-000000000101/faces/00000000-0000-4000-8000-000000000201.jpg", "contentType": "image/jpeg", "byteSize": 132556, "source": "upload", "createdAt": "2026-08-08T12:00:00+00:00" }, "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 } ] }}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.
Eliminar foto DELETE
Elimina la foto facial de la persona en Fusehub y en los terminales vinculados.