Version: beta

Endpoint Biometría

Este endpoint es el entrypoint del API y maneja todas las peticiones hacia los microservicios de Apptenticate. Estas peticiones deben contener al menos dos parámetros: la cédula de un ciudadano y una imágen .jpg del rostro del mismo. Al final, el servicio del tribunal electoral responderá si este rostro corresponde a la cédula indicada.

** NOTA **

• La respuesta puede ser 401 unauthorized si el token JWT debe ser refrescado.

• La imagen enviada en formato jpg no debe exceder los 2MB

• Si se desea obtener en la respuesta el ID de la transacción, se debe indicar "id": "True" en en el JSON de la request

• Si se desea mejorar la precisión de la prueba de vida (si este servicio está contratado), se debe indicar el tipo de dispositivo en el JSON de la request. Estos pueden ser "DESKTOP", "IOS" o "ANDROID" y la manera de especificarlo sería "dispositivo":"IOS", por ejemplo.

Estructura de requests - método: POST

Ruta: {URL Base} 

• Payload para request base

Payload: {'cedula':'Cédula del ciudadano',
         'imagen': imagen} //donde la imagen es un archivo .jpg

• Si se desea obtener el ID de la transacción:

Payload: {'id':True,'cedula':'Cédula del ciudadano',
         'imagen': imagen} //donde la imagen es un archivo .jpg)

• Si se desea mejorar la precisión de la prueba de vida 

Payload: {'cedula':'Cédula del ciudadano', 'dispositivo':'IOS',// Dispositivos: IOS, ANDROID o DESKTOP
         'imagen': imagen} //donde la imagen es un archivo .jpg

Ejemplos de requests

Python

# JWT Token
header = {'Authorization': 'Bearer {}'.format(token)}

# Payload para request base

data = {'cedula':'Cédula del ciudadano'}
files = {'imagen': imagen} # Donde la imagen es un archivo .jpg

# Si se desea obtener el ID de la transacción:

data = {'id':True,'cedula':'Cédula del ciudadano'}
files = {'imagen': imagen} # Donde la imagen es un archivo .jpg)

# Si se desea mejorar la precisión de la prueba de vida 

data = {'cedula':'Cédula del ciudadano', 'dispositivo':'IOS'} # Dispositivos: IOS, ANDROID o DESKTOP
files = {'imagen': imagen} # Donde la imagen es un archivo .jpg

# Envío de request
response = requests.post(apptenticate_url,data=data,files=files, headers=header)
response = json.loads(response.content)

Estructura de respuestas

Formato de respuesta: JSON

• Respuesta base

Respuesta: {
    "valid": True o False // Booleano el cual determina si la petición resulto en una validación exitosa o no,
    "message": "String que contiene la información de fallo de la validación biomatrica o null en su defecto",
    "code": código de error (int)
}

• Respuesta con ID de transacción

Respuesta: {
    "valid": True o False // Booleano el cual determina si la petición resulto en una validación exitosa o no,
    "message": "String que contiene la información de fallo de la validación biomatrica o null en su defecto",
    "code": código de error (int),
    "id" : número de transacción (int)
}

Endpoint Biometría