Ir al contenido
Fusehub
ACS

Cambiar foto

PUT
/api/integration/v1/sites/{site_id}/acs/persons/by-external/{external_person_id}/photo

Pone o reemplaza la foto de la cara de la persona y la envía a sus terminales. Se envía como multipart/form-data en el campo photo.

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.

external_person_id*External Person Id

Identificador de la persona, el mismo que se envió al crearla.

multipart/form-data
  1. body
photo*Photo

Foto de la cara en JPEG o PNG.

Cuerpo de la respuesta

OK

application/json
  1. response
ok?Ok
Por defectotrue
face?|null
deleted?boolean|null
sync?|null
[key: string]?any
Ejemplo de petición
curl -X PUT 'https://api.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      }    ]  }}