Integración de BCC Services

Introducción

BCC Services es un componente de software utilizado para captura biométrica. BCC Services se usa para recopilar imágenes biométricas, pero no las envía automáticamente al servidor. Puede ver cómo enviar una captura al GBDS en la sección Registro en el GBDS.

BCC Services no guarda los datos biométricos recopilados y solo los mantiene en la RAM mientras esté activo. Reiniciar o apagar la computadora o cerrar BCC Services resultará en la pérdida de las colecciones.

Este manual describe el flujo de trabajo y la solución de problemas estándar de captura biométrica de BCC Services. Consulte la especificación de la API de BCC Services para obtener más información sobre las llamadas de API.

Este manual está actualizado para la versión 2.8.8 de BCC Services.

Flujo de Captura

Esta sección describirá el flujo de captura y las opciones de capturas biométricas que puede realizar con BCC Services. Un ejemplo de las llamadas y respuestas del endpoint puede verse en el Ejemplo de Flujo de Captura

Para iniciar una captura, necesita llamar a uno de los endpoints de captura biométrica. Estos son:

Estas capturas pueden devolver una de dos respuestas:

  • 200, para OK

  • 400, para ERROR

El estado 200 tendrá un campo tguid que debe guardar. Cada llamada de Captura Biométrica tendrá su ID único, independiente de cuántas capturas se realicen en la misma llamada. es decir, puede realizar la llamada Captura de Huella Dactilar para recopilar los diez dedos, generando un tguid para todas las capturas, o usando el mismo endpoint diez veces, generando un tguid para cada huella dactilar.

La captura biométrica genera una ventana de captura. Para obtener el estado de captura, ejecute la llamada de estado. Este endpoint devolverá el estado de captura, la información del sensor y una información parcial de qué biometrías están capturadas.

Debe realizar la llamada de estado hasta que el valor del campo estado sea captured. Esto indicará que la captura fue completada. Otros estados pueden verse si la captura está incompleta, como capturing si la ventana de captura aún está abierta o closed si la ventana de captura se ha cerrado sin completar la captura.

Al obtener el estado captured, necesita ejecutar la llamada de getProfile. La respuesta de esta llamada contiene las imágenes .wsq y .jpeg. Estas están en el campo buffer y convertido-buffer, respectivamente, como bytearrays en formato base64.

Tras la finalización de una captura, recomendamos guardar las imágenes en una base de datos local hasta enviarlas al servidor.

BCC Services guarda la captura en la RAM. Salir de BCC Services, apagar o reiniciar la computadora sin persistir los datos de la transacción resultará en pérdida de datos.

Después de que todas las capturas necesarias se hayan realizado, reinicie los servicios BCC usando la llamada restartBcc.

Reiniciar BCC Services limpiará todos los datos de transacciones en la RAM. Asegúrese de que sus datos estén guardados antes de reiniciar BCC Services.

La llamada restartBcc cerrará BCC Services y lo reabrirá automáticamente. Para asegurar que el software esté en ejecución después del reinicio, ejecute la llamada serviceStatus y verifique si el valor del campo serverState es running.

Reabrir ventana de captura incompleta

Si el usuario cerró la ventana de captura sin finalizar la captura, la llamada de estado devolverá el valor del estado como closed. Puede continuar una captura interrumpida con la llamada openCapture pasando el tguid proporcionado por la llamada de captura biométrica. Esto mantendrá el progreso de la captura.

Recuperando TGUID

Si perdió un TGUID por cualquier motivo, podrá recuperar el TGUID usando la llamada listCaptureInstances. Dentro del array de instances, puede encontrar todas las capturas biométricas realizadas mientras BCC Services estaba activo (si el historial de transacciones no fue limpiado). Listará en el orden de ejecución, la primera será la primera Captura Biométrica llamada y la última será la última Captura Biométrica llamada. Un ejemplo de respuesta se muestra a continuación.

{
	"result": "OK",
	"instances": [
		{
			"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77",
			"type": "FINGERPRINT"
		},
		{
			"tguid": "DD08CEAA-B508-421D-8484-717DF01C0C55",
			"type": "SIGNATURE"
		},
		{
			"tguid": "EB321A10-F2B2-46DB-9479-8A6E5A1A485D",
			"type": "PROFILE"
		}
	]
}

Solución de Problemas

BCC Services tiene algunas llamadas para solución de problemas que puede hacer para asegurarse de que las cosas estén funcionando correctamente. Por ejemplo, si sus equipos están siendo identificados y si la versión del software es conocida por usted y por el equipo de soporte que puede ayudarlo con su problema. Estas llamadas se presentan a continuación.

Versión

Verificar la versión del software es esencial para el escenario de solución de problemas. Para verificar la versión de BCC Services, ejecute la llamada de versión.

Ejecución

Para verificar si el programa está ejecutándose, use la llamada de serviceStatus y observe el valor del campo serverState.

Dispositivos

BCC Services ofrece una opción para mostrar todos los dispositivos que están conectados a él. Para mostrar la lista de dispositivos, ejecute la llamada deviceStatus.

Apagado

Para apagar BCC Services, llame a finishService

Ejemplo de Flujo de Captura

En este ejemplo, describiremos cómo realizar las llamadas para un registro de una captura rodada de todos los dedos de la mano izquierda.

Primero, ejecute la Llamada de Captura de Huella Dactilar con la siguiente query:

El campo captureMode no afecta el comportamiento de la captura de BCC Services. Este campo se utiliza para identificar la operación en el BCC.

{
	"captureMode": "REGISTER",
	"notifyUrl": "",
	"theme": "DARK",
	"captureType": "ROLLED",
	"type": "FINGERPRINT",
	"sequenceControlType": "NONE",
	"indexes": [
		{
			"index": "LEFT_LITTLE"
		},
		{
			"index": "LEFT_RING"
		},
		{
			"index": "LEFT_MIDDLE"
		},
		{
			"index": "LEFT_INDEX"
		},
		{
			"index": "LEFT_THUMB"
		}
	],
	"exceptionSetType": "SIMPLIFIED",
	"functions": [
		{
			"type": "RESET",
			"enabled": true
		},
		{
			"type": "CONFIG",
			"enabled": true
		},
		{
			"type": "CLEAR",
			"enabled": true
		},
		{
			"type": "CAPTURE",
			"enabled": true
		},
		{
			"type": "CANCEL",
			"enabled": true
		},
		{
			"type": "CAPTURE_NEW_IMAGE",
			"enabled": true
		},
		{
			"type": "IMAGE_PREVIEW",
			"enabled": true
		},
		{
			"type": "NEXT",
			"enabled": true
		},
		{
			"type": "OK",
			"enabled": true
		},
		{
			"type": "UPDATE_IMAGE",
			"enabled": true
		},
		{
			"type": "REMOVE_IMAGE",
			"enabled": true
		},
		{
			"type": "LIVE",
			"enabled": true
		},
		{
			"type": "ACQUIRE",
			"enabled": true
		},
		{
			"type": "SAVE",
			"enabled": true
		},
		{
			"type": "IMPORT",
			"enabled": true
		}
	]
}

Si la pantalla se abre con éxito, recibirá este JSON:

{
	"result": "OK",
	"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77"
}

Copie este TGUID y comience a llamar a estado. hasta recibir el estado captured.

Recuerde que otros estados, como closed, también pueden devolversi el operador no completa la captura.

Si ningún dedo fue capturado, la respuesta debe ser:

{
	"result": "OK",
	"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77",
	"type": "FINGERPRINT",
	"status": "CAPTURING",
	"operation": "INIT",
	"command": "INIT",
	"profile": {},
	"profileMetadata": {
		"profileVersion": "GBS BCC profile v2.8.7",
		"appName": "GBS BCC",
		"macAddress": [
			"08-62-66-80-D5-5C",
			"42-E2-30-11-DB-15",
			"42-E2-30-11-D3-15",
			"08-62-66-80-D4-94",
			"40-E2-30-13-F7-8A",
			"40-E2-30-11-D3-15"
		],
		"softwareStatus": {
			"vendor": "Griaule Biometrics Ltda.",
			"version": "2.8.7.10805",
			"name": "GBS BCC Service"
		},
		"fingerprintPluggedDevices": [],
		"fingerprintStartedDevices": [],
		"faceDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"bodyDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"signatureDevice": {
			"serialNumber": "N/A"
		},
		"irisDevice": "IRITECH",
		"fields": [],
		"fingerprints": [],
		"palms": [],
		"bodyImages": []
	},
	"windowInfo": {
		"x": 683.0,
		"y": 237.0,
		"width": 685.0,
		"height": 579.0,
		"state": "NORMAL"
	}
}

Si algunos dedos fueron capturados, pero la captura no fue finalizada, el estado responderá con la información de captura parcial, como se muestra:

{
	"result": "OK",
	"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77",
	"type": "FINGERPRINT",
	"status": "CAPTURING",
	"operation": "INIT",
	"command": "INIT",
	"profileMetadata": {
		"profileVersion": "GBS BCC profile v2.8.7",
		"appName": "GBS BCC",
		"macAddress": [
			"08-62-66-80-D5-5C",
			"42-E2-30-11-DB-15",
			"42-E2-30-11-D3-15",
			"08-62-66-80-D4-94",
			"40-E2-30-13-F7-8A",
			"40-E2-30-11-D3-15"
		],
		"softwareStatus": {
			"vendor": "Griaule Biometrics Ltda.",
			"version": "2.8.7.10805",
			"name": "GBS BCC Service"
		},
		"fingerprintPluggedDevices": [],
		"fingerprintStartedDevices": [],
		"faceDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"bodyDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"signatureDevice": {
			"serialNumber": "N/A"
		},
		"irisDevice": "IRITECH",
		"fields": [],
		"fingerprints": [
			{
				"index": "LEFT_LITTLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left little",
				"image": {
					"resolution": 500
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 96
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 72,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_RING",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left ring",
				"image": {
					"resolution": 500
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 66,
				"captured": false,
				"extracted": true
			}
		],
		"palms": [],
		"bodyImages": []
	},
	"windowInfo": {
		"x": 683.0,
		"y": 237.0,
		"width": 685.0,
		"height": 579.0,
		"state": "NORMAL"
	}
}

Tras el fin de la captura, el campo de estado cambiará a captured y la llamada de estado responderá con:

Los valores BYTEARRAY son cadenas en formato base64.

{
	"result": "OK",
	"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77",
	"type": "FINGERPRINT",
	"status": "CAPTURED",
	"operation": "INIT",
	"command": "NONE",
	"profileMetadata": {
		"profileVersion": "GBS BCC profile v2.8.7",
		"appName": "GBS BCC",
		"macAddress": [
			"08-62-66-80-D5-5C",
			"42-E2-30-11-DB-15",
			"42-E2-30-11-D3-15",
			"08-62-66-80-D4-94",
			"40-E2-30-13-F7-8A",
			"40-E2-30-11-D3-15"
		],
		"softwareStatus": {
			"vendor": "Griaule Biometrics Ltda.",
			"version": "2.8.7.10805",
			"name": "GBS BCC Service"
		},
		"fingerprintPluggedDevices": [],
		"fingerprintStartedDevices": [],
		"faceDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"bodyDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"signatureDevice": {
			"serialNumber": "N/A"
		},
		"irisDevice": "IRITECH",
		"fields": [],
		"fingerprints": [
			{
				"index": "LEFT_LITTLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left little",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 96
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 72,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_RING",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left ring",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 66,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_MIDDLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left middle",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 76,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_INDEX",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left index",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 71,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_THUMB",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left thumb",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 70,
				"captured": false,
				"extracted": true
			}
		],
		"palms": [],
		"bodyImages": []
	},
	"windowInfo": {
		"x": 683.0,
		"y": 237.0,
		"width": 1000.0,
		"height": 579.0,
		"state": "NORMAL"
	}
}

Después de una transacción completa, la llamada de estado responde con las imágenes .jpeg.

Ahora es hora de realizar la llamada getProfile. Esta llamada responderá con las imágenes en imágenes .wsq y .jpeg. El campo buffer contiene las imágenes .wsq mientras que el campo converted-buffer contiene las imágenes .jpeg.

{
	"result": "OK",
	"tguid": "F1F14ADA-6A00-4A67-B887-F574764ECC77",
	"type": "FINGERPRINT",
	"status": "CAPTURED",
	"operation": "INIT",
	"command": "NONE",
	"profile": {
		"fingerprints": [
			{
				"index": "LEFT_LITTLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left little",
				"image": {
					"buffer": "BYTEARRAY",
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"buffer": "BYTEARRAY",
					"quality": 96
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 72,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_RING",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left ring",
				"image": {
					"buffer": "BYTEARRAY",
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"buffer": "BYTEARRAY",
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 66,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_MIDDLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left middle",
				"image": {
					"buffer": "BYTEARRAY",
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"buffer": "BYTEARRAY",
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 76,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_INDEX",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left index",
				"image": {
					"buffer": "BYTEARRAY",
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"buffer": "BYTEARRAY",
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 71,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_THUMB",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left thumb",
				"image": {
					"buffer": "BYTEARRAY",
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"buffer": "BYTEARRAY",
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 70,
				"captured": false,
				"extracted": true
			}
		]
	},
	"profileMetadata": {
		"profileVersion": "GBS BCC profile v2.8.7",
		"appName": "GBS BCC",
		"macAddress": [
			"08-62-66-80-D5-5C",
			"42-E2-30-11-DB-15",
			"42-E2-30-11-D3-15",
			"08-62-66-80-D4-94",
			"40-E2-30-13-F7-8A",
			"40-E2-30-11-D3-15"
		],
		"softwareStatus": {
			"vendor": "Griaule Biometrics Ltda.",
			"version": "2.8.7.10805",
			"name": "GBS BCC Service"
		},
		"fingerprintPluggedDevices": [],
		"fingerprintStartedDevices": [],
		"faceDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"bodyDevice": {
			"productName": "OBS Virtual Camera",
			"serialNumber": "N/A",
			"firmwareVersion": "N/A"
		},
		"signatureDevice": {
			"serialNumber": "N/A"
		},
		"irisDevice": "IRITECH",
		"fields": [],
		"fingerprints": [
			{
				"index": "LEFT_LITTLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left little",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 96
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 72,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_RING",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left ring",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 66,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_MIDDLE",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left middle",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 98
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 76,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_INDEX",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left index",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 71,
				"captured": false,
				"extracted": true
			},
			{
				"index": "LEFT_THUMB",
				"type": "ROLLED",
				"typeIndexKey": "ROLLED-left thumb",
				"image": {
					"resolution": 500,
					"converted-buffer": "BYTEARRAY"
				},
				"height": 480,
				"width": 320,
				"template": {
					"quality": 100
				},
				"captureType": "FLAT",
				"nfiq": 1,
				"contrast": 70,
				"captured": false,
				"extracted": true
			}
		],
		"palms": [],
		"bodyImages": []
	},
	"windowInfo": {
		"x": 683.0,
		"y": 237.0,
		"width": 685.0,
		"height": 579.0,
		"state": "NORMAL"
	}
}

Después de la captura, puede enviar las imágenes al servidor. Para entender cómo registrar la biometría capturada en el GBDS, vaya a la siguiente sección.

Registro en el GBDS

Llame al endpoint de enroll si desea registrar las imágenes capturadas anteriormente en el GBDS.

En el payload necesita insertar la información de las claves (keys) y biográficos (biographics). Dentro del array biometric, necesitará insertar los datos del endpoint getCapture de BCC Services.

El valor del campo buffer BCC Services necesita ser colocado en el valor del campo content en el payload del JSON para el GBDS.

Para obtener más información sobre operaciones en el GBDS, consulte el Manual de Integración del GBDS.

El payload de ejemplo para realizar el registro se muestra a continuación:

{
	"meta": {
		"priority": "DEFAULT_PRIORITY",
		"timeout": "-1"
	},
	"data": {
		"keys": [
			{
				"id": "CPF",
				"value": "618.323.606-44"
			}
		],
		"biographics": [
			{
				"id": "name",
				"value": "John Doe"
			}
		],
		"biometric": [
			{
				"source": "ORIGINAL",
				"type": "FINGERPRINT",
				"format": "WSQ",
				"properties": {
					"width": 0,
					"height": 0,
					"resolution": 500,
					"ratio": 0.0,
					"matcherId": 0,
					"extractorId": 0
				},
				"index": 0,
				"content": "BYTEARRAY"
			},
			{
				"source": "ORIGINAL",
				"type": "FINGERPRINT",
				"format": "WSQ",
				"properties": {
					"width": 0,
					"height": 0,
					"resolution": 500,
					"ratio": 0.0,
					"matcherId": 0,
					"extractorId": 0
				},
				"index": 1,
				"content": "BYTEARRAY"
			},
			{
				"source": "ORIGINAL",
				"type": "FINGERPRINT",
				"format": "WSQ",
				"properties": {
					"width": 0,
					"height": 0,
					"resolution": 500,
					"ratio": 0.0,
					"matcherId": 0,
					"extractorId": 0
				},
				"index": 2,
				"content": "BYTEARRAY"
			},
			{
				"source": "ORIGINAL",
				"type": "FINGERPRINT",
				"format": "WSQ",
				"properties": {
					"width": 0,
					"height": 0,
					"resolution": 500,
					"ratio": 0.0,
					"matcherId": 0,
					"extractorId": 0
				},
				"index": 3,
				"content": "BYTEARRAY"
			},
			{
				"source": "ORIGINAL",
				"type": "FINGERPRINT",
				"format": "WSQ",
				"properties": {
					"width": 0,
					"height": 0,
					"resolution": 500,
					"ratio": 0.0,
					"matcherId": 0,
					"extractorId": 0
				},
				"index": 4,
				"content": "BYTEARRAY"
			}
		]
	}
}

Anotación de anomalía en la captura

Para que una anomalía en la captura de la huella dactilar sea registrada, el metadato de la transacción debe incluir el objeto fingerprints. Este objeto debe contener los índices de los dedos y sus respectivas anomalías.

Ejemplo:

"fingerprints": [
    {
        "index": "LEFT_LITTLE",
        "anomaly": "AMPUTATED"
    }
]

Los índices son ENUMs:

  • LEFT_LITTLE

  • LEFT_RING

  • LEFT_MIDDLE

  • LEFT_INDEX

  • LEFT_THUMB

  • RIGHT_THUMB

  • RIGHT_INDEX

  • RIGHT_MIDDLE

  • RIGHT_RING

  • RIGHT_LITTLE

Los tipos de anomalías son:

  • DAMAGED

  • BANDAGED

  • IGNORED

  • AMPUTATED

El metadato debe ser añadido al enroll en formato base64, de la siguiente manera:

"data": {
    "keys": [
		...
    ],
    "biographics": [
    	...
    ],
    "labels": [
        ...
    ],
    "metadata": "ewoJInByb2ZpbGVWZXJzaW9uIjogIkdCRFMgcHJvZmlsZSIsCgkiYXBwTmFtZSI6ICJHQkRTIiwKCSJmaW5nZXJwcmludHMiOiBbCgkJewoJCQkiaW5kZXgiOiAiTEVGVF9MSVRUTEUiLAoJCQkidHlwZSI6ICJST0xMRUQiLAoJCQkidHlwZUluZGV4S2V5IjogIlJPTExFRC1MRUZUX0xJVFRMRSIsCgkJCSJjYXB0dXJlVHlwZSI6ICJST0xMRUQiLAoJCQkiYW5vbWFseSI6ICJEQU1BR0VEIiwKCQkJIm5maXEiOiAwLAoJCQkiY29udHJhc3QiOiAwLAoJCQkiY2FwdHVyZWQiOiBmYWxzZSwKCQkJImV4dHJhY3RlZCI6IGZhbHNlCgkJfSwKCQl7CgkJCSJpbmRleCI6ICJMRUZUX1JJTkciLAoJCQkidHlwZSI6ICJST0xMRUQiLAoJCQkidHlwZUluZGV4S2V5IjogIlJPTExFRC1MRUZUX1JJTkciLAoJCQkiY2FwdHVyZVR5cGUiOiAiUk9MTEVEIiwKCQkJImFub21hbHkiOiAiQkFOREFHRUQiLAoJCQkibmZpcSI6IDAsCgkJCSJjb250cmFzdCI6IDAsCgkJCSJjYXB0dXJlZCI6IGZhbHNlLAoJCQkiZXh0cmFjdGVkIjogZmFsc2UKCQl9LAoJCXsKCQkJImluZGV4IjogIkxFRlRfTUlERExFIiwKCQkJInR5cGUiOiAiUk9MTEVEIiwKCQkJInR5cGVJbmRleEtleSI6ICJST0xMRUQtTEVGVF9NSURETEUiLAoJCQkiY2FwdHVyZVR5cGUiOiAiUk9MTEVEIiwKCQkJImFub21hbHkiOiAiSUdOT1JFRCIsCgkJCSJuZmlxIjogMCwKCQkJImNvbnRyYXN0IjogMCwKCQkJImNhcHR1cmVkIjogZmFsc2UsCgkJCSJleHRyYWN0ZWQiOiBmYWxzZQoJCX0sCgkJewoJCQkiaW5kZXgiOiAiTEVGVF9JTkRFWCIsCgkJCSJ0eXBlIjogIlJPTExFRCIsCgkJCSJ0eXBlSW5kZXhLZXkiOiAiUk9MTEVELUxFRlRfSU5ERVgiLAoJCQkiY2FwdHVyZVR5cGUiOiAiUk9MTEVEIiwKCQkJImFub21hbHkiOiAiQU1QVVRBVEVEIiwKCQkJIm5maXEiOiAwLAoJCQkiY29udHJhc3QiOiAwLAoJCQkiY2FwdHVyZWQiOiBmYWxzZSwKCQkJImV4dHJhY3RlZCI6IGZhbHNlCgkJfQogICAgXQp9",
    "biometric": [
		...
    ]
}

El campo "metadata", representado en base64 en el ejemplo anterior, corresponde al siguiente JSON:

El JSON debe contener al menos el campo “fingerprints” y dentro de cada ítem como mínimo los campos "index" y "anomaly".

{
    "profileVersion": "GBDS profile",
    "appName": "GBDS",
    "fingerprints": [
        {
            "index": "LEFT_LITTLE",
            "type": "ROLLED",
            "typeIndexKey": "ROLLED-LEFT_LITTLE",
            "captureType": "ROLLED",
            "anomaly": "DAMAGED",
            "nfiq": 0,
            "contrast": 0,
            "captured": false,
            "extracted": false
        },
        {
            "index": "LEFT_RING",
            "type": "ROLLED",
            "typeIndexKey": "ROLLED-LEFT_RING",
            "captureType": "ROLLED",
            "anomaly": "BANDAGED",
            "nfiq": 0,
            "contrast": 0,
            "captured": false,
            "extracted": false
        },
        {
            "index": "LEFT_MIDDLE",
            "type": "ROLLED",
            "typeIndexKey": "ROLLED-LEFT_MIDDLE",
            "captureType": "ROLLED",
            "anomaly": "IGNORED",
            "nfiq": 0,
            "contrast": 0,
            "captured": false,
            "extracted": false
        },
        {
            "index": "LEFT_INDEX",
            "type": "ROLLED",
            "typeIndexKey": "ROLLED-LEFT_INDEX",
            "captureType": "ROLLED",
            "anomaly": "AMPUTATED",
            "nfiq": 0,
            "contrast": 0,
            "captured": false,
            "extracted": false
        }
    ]
}

Última actualización

¿Te fue útil?