Voice Authentication

Servicio que compara un audio contra una plantilla de voz emitida en el enrolamiento y devuelve el resultado con su puntuación.

Endpoint

POST /biometric/voice/authentication

Headers

Nombre	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de consumer en formato Bearer <token>. Ver Autenticación.
consumer-id	string	Sí	Identificador del consumer.

Cuerpo de la solicitud

Content-Type: application/json

Parámetros

Parámetro	Tipo	Requerido	Descripción
audio	string	Sí	Audio a autenticar, en Base64.
template	string	Sí	Plantilla de voz emitida en el enrolamiento.

Ejemplo de solicitud

{
  "audio": "<base64 audio>",
  "template": "<plantilla de voz>"
}

Respuestas

200 Éxito

Parámetros de respuesta

Parámetro	Tipo	Descripción
consumerId	string	Identificador del consumer que realizó la llamada.
transactionId	string	Identificador de la transacción.
timestamp	string	Marca de tiempo de la respuesta en formato ISO 8601.
message	string	Campo descriptivo del resultado de la ejecución del servicio.
operationResult	integer	Código de resultado de la ejecución del servicio.
match	boolean	Indica si el audio corresponde a la plantilla.
matchingScore	number	Puntuación de coincidencia.
livenessScore	number	Puntuación de prueba de vida del audio.

Otras respuestas

Código	Descripción
400	Campo obligatorio ausente, audio con formato no admitido o plantilla inválida.
401	Token ausente, inválido o caducado.
403	El consumer no está aprovisionado con el servicio VOICE_AUTHENTICATION.

El cuerpo de una respuesta de error tiene la forma descrita en Middleware API v2.