Consultar Foto Facial

Descripción

Consulta si una persona posee una foto de reconocimiento facial registrada en EVO y, cuando está disponible, devuelve una URL autenticada para acceder a la foto.

La consulta puede realizarse mediante el identificador de la foto (idPhoto) o mediante el identificador de la persona, que puede ser un miembro, prospecto, empleado o personal. La URL devuelta tiene una validez de 1 hora.

🚧 Observaciones
Es necesario contar con el permiso Control de acceso — Consulta en la clave de API utilizada.
Se debe informar al menos uno de los parámetros idPhoto, idMember, idProspect, idEmployee o idPersonal.
La consulta respeta el alcance de la clave de API. Una clave de sucursal permite consultar únicamente personas pertenecientes a la propia sucursal. Las claves de ADM General (multisucursal) pueden realizar consultas sin esta restricción.
La URL devuelta es temporal y tiene una validez de 1 hora.

🔑 Parámetros de Consulta (Query Params)

Parámetro	Tipo	Obligatoriedad	Descripción
`idPhoto`	int32	Condicional	Identificador de la foto facial. Puede obtenerse a través del `IdRecord` del webhook `FacialPhotoRegistered`.
`idMember`	int32	Condicional	Identificador del miembro cuya foto facial será consultada.
`idProspect`	int32	Condicional	Identificador del prospecto cuya foto facial será consultada.
`idEmployee`	int32	Condicional	Identificador del empleado cuya foto facial será consultada.
`idPersonal`	int32	Condicional	Identificador del personal cuya foto facial será consultada.

📤 Estructura de la Respuesta

La respuesta informa si la persona posee una foto de reconocimiento facial registrada y, cuando existe, proporciona una URL temporal para acceder a la imagen.

Campo	Tipo	Descripción
`hasFacialPhoto`	boolean	Indica si la persona posee una foto facial registrada (`true` o `false`).
`url`	string	URL autenticada para acceder a la foto facial, con una validez de 1 hora. Se devuelve vacía cuando `hasFacialPhoto` es `false`.
`idMember`	int32	Identificador del miembro propietario de la foto, cuando la foto pertenece a un miembro.
`idProspect`	int32	Identificador del prospecto propietario de la foto, cuando la foto pertenece a un prospecto.
`idEmployee`	int32	Identificador del empleado propietario de la foto, cuando la foto pertenece a un empleado.
`idPersonal`	int32	Identificador del personal propietario de la foto, cuando la foto pertenece a un personal.

OBS. Los campos de identificación permiten determinar a la persona propietaria de la foto, especialmente en consultas realizadas mediante idPhoto. Solo se completará el identificador correspondiente al tipo de persona. Cuando hasFacialPhoto sea false, los identificadores se devolverán como null.

Envía tus solicitudes HTTP con un encabezado

Authorization

que contenga la palabra Basic seguida de un espacio y una cadena codificada en base64 username:password

Ejemplo:

Authorization: Basic *****************

Ejemplos de solicitud

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Get the facial recognition photo of a member, prospect, employee or personal trainer.

Consultar Foto Facial

Descripción

🔑 Parámetros de Consulta (Query Params)

📤 Estructura de la Respuesta

Solicitud

Ejemplos de solicitud

Respuestas

Get the facial recognition photo of a member, prospect, employee or personal trainer.

Consultar Foto Facial#

Descripción#

🔑 Parámetros de Consulta (Query Params)#

📤 Estructura de la Respuesta#

Solicitud

Ejemplos de solicitud

Respuestas

Consultar Foto Facial

Descripción

🔑 Parámetros de Consulta (Query Params)

📤 Estructura de la Respuesta