Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

• Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/validate_biometricselfie

Parámetros:

• token-susc: Token obtenido al momento de la suscripción a nivel empresa.
• token-api: Token obtenido al momento de la suscripción a nivel API.
• document: Número de documento sin puntos.
• docfront: Colección de datos indicando los diferentes rasgos y emociones observadas en la foto que se encuentra en el DNI.
• selfie1: Colección de datos indicando los diferentes rasgos y emociones observadas en la primera selfie solicitada.
• selfie2: Colección de datos indicando los diferentes rasgos y emociones observadas en la segunda selfie solicitada.
• verify1*: Score de positividad obtenida entre las dos selfies (rango que va de 0 a 1, donde 0 es nada parecido y 1 es 100% de efectividad).
• verify2*: Score de positividad obtenida entre la primera selfie y la foto del DNI (rango que va de 0 a 1, donde 0 es nada parecido y 1 es 100% de efectividad).
• internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.

La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/validate_biometricselfie?token-susc=TOKENSUSC&token-api=TOKENAPI&folder=FOLDER&document=23123456&internalid=45

Luego se debe enviar por el método "POST" las imágenes previamente convertidas a Base64 con formato JSON, quedando conformada de la siguiente forma:
{"docfront":"base64","selfie1":"base64", "selfie2":"base64"}.

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
• desc: Descripción del parámetro recibido.
• docfront: Colección de datos indicando los diferentes rasgos y emociones observadas en la foto que se encuentra en el DNI del lado del frente.
  • faceId: Número de ID de identificación del rostro.
  • faceRectangle: Devuelve una escala de valores entre 0 y 1, donde 0 no demuestra un rectángulo de su rostro y 1 si así lo hace.
    • top: Devuelve una escala de valores entre 0 y 1, donde 0  indica que la imagen no es de la parte superior del cuerpo y 1 si así lo es.
    • left: Devuelve una escala de valores entre 0 y 1, donde 0  indica que la imagen no es desde el perfil izquierdo y 1 si así lo es.
    • width : Indica la anchura de la imagen.
    • height: Indica la altura de la imagen.
  • gender: Género de la persona consultada.
  • age: Edad de la persona consultada.
  • facialHair: Indica si tiene vello facial.
    • moustache: Indica si tiene bigote.
    • beard: Indica si tiene barba.
    • sideburns: Indica si tiene patillas.
  • glasses: Indica si usa anteojos.
  • emotion: En los siguientes puntos se detalla los valores acorde a las emociones que indique la persona en la foto.
    • anger: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de ira y 1 si así lo hace.
    • contempt: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de desprecio y 1 si así lo hace.
    • disgust: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de disgusto y 1 si así lo hace.
    • fear: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de miedo y 1 si así lo hace.
    • happiness: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de felicidad y 1 si así lo hace.
    • neutral: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión neutral y 1 si así lo hace. 
    • sadness: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de tristeza y 1 si así lo hace.
    • surprise: Devuelve una escala de valores entre 0 y 1, donde 0 no indica la expresión de sorpresa y 1 si así lo hace.
  • blur: Devuelve una escala de valores entre 0 y 1, donde 0 indica que la imagen no está difuminada, y 1 si está difuminada.
    • blurLevel: Nivel de difuminación de la imagen.
    • value: Valor que se le asignará a cada parámetro.
  • exposure: Indica la cantidad de luz que tiene la imagen.
    • exposureLevel: Nivel de cantidad de luz que tiene la imagen.
    • value: Valor que se le asignará a cada parámetro.
  • noise: Indica si la imagen tiene ´´manchas´´ o ´´luces´´ no deseadas.
    • noiseLevel: Indica el nivel de las ´´manchas´´ o ´´luces´´ en la imagen.
    • value: Valor que se le asignará a cada parámetro.
  • makeup: Indica si la persona está maquillada.
    • eyeMakeup: Indica si la persona tiene maquillada el ojo.
    • lipMakeup:Indica si la persona tiene pintados los labios.
  • accessories: Indica si usa algún accesorio.
  • occlusion: Indica la percepción visual de un objeto estando atrás o en frente de otro objeto, otorgando información sobre el orden de las capas de la textura.
    • foreheadOccluded: Devuelve una escala de valores entre false y true, donde false indica que la imagen en la parte de la cabeza no está obstruida por un objeto, y true si la imagen está obstruida por un objeto.
    • eyeOccluded: Devuelve una escala de valores entre false y true, donde false indica que la imagen en la parte del ojo no está obstruida por un objeto, y true si la imagen está obstruida por un objeto.
    • mouthOccluded: Devuelve una escala de valores entre false y true, donde false indica que la imagen en la parte del boca no está obstruida por un objeto, y true si la imagen está obstruida por un objeto.
  • hair: Indica el tipo de pelo que tiene la persona consultada.
    • bald: Indica si la persona es calva.
    • invisible: Devuelve una escala de valores entre false y true, donde false indica que detecta el color del pelo y true indica que el detecta el color del pelo.  
    • hairColor: Indica los valores del pelo.
      • color: Indica el color del pelo.
      • confidence: Devuelve la intensidad del color en una escala del 0 al 1 ( del menos intenso al más intenso)
• docback: Colección de datos indicando los diferentes rasgos y emociones observadas en la foto que se encuentra en el DNI del lado del dorso. Devuelve los mismos parámetros que docfront.
• selfie1: Colección de datos indicando los diferentes rasgos y emociones observadas en la primera selfie solicitada. Devuelve los mismos parámetros que docfront y los compara.
• selfie2: Colección de datos indicando los diferentes rasgos y emociones observadas en la segunda selfie solicitada. Devuelve los mismos parámetros que docfront y los compara.
• verify1: Score de positividad obtenida entre las dos selfies (rango que va de 0 a 1, donde 0 es nada parecido y 1 es 100% de efectividad).
  • isIdentical: Indica si los datos coinciden(true) o no (false)
  • confidence: Devuelve la intensidad de la coincidencia en una escala del 0 al 1 ( del menos intenso al más intenso)
• verify2: Score de positividad obtenida entre la primera selfie y la foto del DNI (rango que va de 0 a 1, donde 0 es nada parecido y 1 es 100% de efectividad). Al realizar la verificación devuelve los mismos parámetros que verify1.
• gender: Género de la persona consultada. Devuelve un valor nulo en caso de inconsistencias al realizar la validación.
• type: Tipo de documento. Devuelve un valor nulo en caso de inconsistencias al realizar la validación.
• doc_id: Número ID del documento. Devuelve un valor nulo en caso de inconsistencias al realizar la validación.
• digit: Cantidad de dígitos introducidos. Devuelve un valor nulo en caso de inconsistencias al realizar la validación.
• id_internal: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"docfront required","id_internal":""}

Positiva:

{"state":"1","docfront":[{"faceId":"388da9f3-410d-449a-8593-eb0144e969e0","faceRectangle":{"top":344,"left":221,"width":200,"height":200},"faceAttributes":{"smile":0.247,"headPose":{"pitch":-0.6,"roll":-2.4,"yaw":-5.2},"gender":"male","age":29.0,"facialHair":{"moustache":0.1,"beard":0.1,"sideburns":0.1},"glasses":"NoGlasses","emotion":{"anger":0.0,"contempt":0.0,"disgust":0.0,"fear":0.0,"happiness":0.247,"neutral":0.753,"sadness":0.0,"surprise":0.0},"blur":{"blurLevel":"high","value":1.0},"exposure":{"exposureLevel":"goodExposure","value":0.75},"noise":{"noiseLevel":"medium","value":0.59},"makeup":{"eyeMakeup":false,"lipMakeup":false},"accessories":[],"occlusion":{"foreheadOccluded":false,"eyeOccluded":false,"mouthOccluded":false},"hair":{"bald":0.06,"invisible":false,"hairColor":[{"color":"brown","confidence":0.97},{"color":"black","confidence":0.93},{"color":"gray","confidence":0.53},{"color":"blond","confidence":0.31},{"color":"other","confidence":0.1},{"color":"red","confidence":0.04},{"color":"white","confidence":0.0}]}}}],"docback":[],"selfie1":[{"faceId":"90cc7b35-e2f4-4f77-9f72-766708caa672","faceRectangle":{"top":212,"left":128,"width":234,"height":234},"faceAttributes":{"smile":1.0,"headPose":{"pitch":-1.7,"roll":0.1,"yaw":-1.4},"gender":"male","age":21.0,"facialHair":{"moustache":0.1,"beard":0.1,"sideburns":0.1},"glasses":"NoGlasses","emotion":{"anger":0.0,"contempt":0.0,"disgust":0.0,"fear":0.0,"happiness":1.0,"neutral":0.0,"sadness":0.0,"surprise":0.0},"blur":{"blurLevel":"low","value":0.22},"exposure":{"exposureLevel":"goodExposure","value":0.58},"noise":{"noiseLevel":"low","value":0.11},"makeup":{"eyeMakeup":false,"lipMakeup":false},"accessories":[],"occlusion":{"foreheadOccluded":false,"eyeOccluded":false,"mouthOccluded":false},"hair":{"bald":0.07,"invisible":false,"hairColor":[{"color":"black","confidence":0.99},{"color":"brown","confidence":0.84},{"color":"gray","confidence":0.34},{"color":"other","confidence":0.34},{"color":"blond","confidence":0.13},{"color":"red","confidence":0.03},{"color":"white","confidence":0.0}]}}}],"selfie2":[{"faceId":"827536a4-9d2d-42c7-887f-94c4a904e63a","faceRectangle":{"top":775,"left":212,"width":1431,"height":1431},"faceAttributes":{"smile":0.0,"headPose":{"pitch":-2.1,"roll":0.1,"yaw":0.4},"gender":"male","age":27.0,"facialHair":{"moustache":0.1,"beard":0.1,"sideburns":0.1},"glasses":"NoGlasses","emotion":{"anger":0.0,"contempt":0.0,"disgust":0.0,"fear":0.0,"happiness":0.0,"neutral":0.999,"sadness":0.001,"surprise":0.0},"blur":{"blurLevel":"medium","value":0.38},"exposure":{"exposureLevel":"goodExposure","value":0.74},"noise":{"noiseLevel":"medium","value":0.34},"makeup":{"eyeMakeup":false,"lipMakeup":false},"accessories":[],"occlusion":{"foreheadOccluded":false,"eyeOccluded":false,"mouthOccluded":false},"hair":{"bald":0.09,"invisible":false,"hairColor":[{"color":"black","confidence":0.99},{"color":"brown","confidence":0.74},{"color":"other","confidence":0.51},{"color":"gray","confidence":0.35},{"color":"blond","confidence":0.09},{"color":"red","confidence":0.07},{"color":"white","confidence":0.0}]}}}],"verify1":[{"isIdentical":true,"confidence":0.70609}],"verify2":[{"isIdentical":false,"confidence":0.44268}],"gender":"","type":"","doc_id":"","digit":"","id_internal":""}

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test

Definición Técnica de la API: