Skip to main content
El servicio de Antispoofing Facial analiza una selfie y responde una sola pregunta: ¿la imagen proviene de una persona real presente frente a la cámara, o de un intento de suplantación? Detecta fotocopias, capturas de pantalla, bordes de otra pantalla dentro del cuadro, marcas de agua, alteraciones cromáticas y deepfakes generados por IA. Se integra con una única llamada HTTP y no requiere SDK.

La regla de decisión

Esta es la parte más importante de la integración. Escríbala en positivo:
No apruebe por descarte. No existe un único código que signifique «rechazado»: el veredicto de suplantación llega con 200, pero una imagen sin rostro llega con 422 y también trae spoofing: true. Si su condición es «rechazar si el código es X», cualquier respuesta inesperada termina aprobada.
No decida sobre errorCode, values, confidence ni info. Esos campos son diagnóstico: sirven para su log y para abrir un ticket con contexto, cambian entre versiones y no forman parte del contrato.

Endpoints

La URL base depende del ambiente y se la entrega VU junto con su api-key. En los ejemplos aparece como BASE_URL.

Autenticación

Cada llamada lleva la cabecera Api-Key con la clave de su ambiente.
La api-key vive en su backend. Nunca la incruste en una app móvil ni en el front-end: cualquiera puede extraerla del binario o del bundle.

Un ejemplo completo

Una aprobación se ve así, recortada a los campos que importan:
id es el identificador de la transacción. Regístrelo siempre: es lo primero que le va a pedir soporte.

Ambientes

Homologación puede ir adelantada respecto de producción. UAT también valida versiones preproductivas, así que puede diferir en tiempos de respuesta y en el resultado del análisis. Úselo para certificar su integración —el contrato, los códigos, el manejo de errores—, no como referencia de performance ni para comparar veredictos imagen por imagen entre ambientes.

Continuar

Integración

Prepare la imagen, arme la llamada y valide su integración antes de producción.

Respuestas

Qué trae cada respuesta, cómo se comporta info y qué componente bloqueó.

Errores

Códigos, cuáles son suyos, cuáles del servicio y cuáles se reintentan.
Última modificación el 9 de septiembre de 2026