Autenticação por voz

Serviço que compara um áudio com uma amostra de voz emitida no cadastro e retorna o resultado com sua pontuação.

Endpoint

POST /biometric/voice/authentication

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de consumer no formato Bearer <token>. Ver Autenticação.
consumer-id	string	Sim	Identificador do consumer.

Corpo da solicitação

Content-Type: application/json

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
áudio	string	Sim	Áudio a autenticar, em Base64.
template	string	Sim	Amostra de voz emitida no cadastro.

Exemplo de solicitação

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

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
consumerId	string	Identificador do consumer que realizou a chamada.
transactionId	string	Identificador da transação.
timestamp	string	Carimbo de data e hora da resposta no formato ISO 8601.
message	string	Campo descritivo do resultado da execução do serviço.
operationResult	integer	Código de resultado da execução do serviço.
match	boolean	Indica se o áudio corresponde à amostra.
matchingScore	number	Pontuação de correspondência.
livenessScore	number	Pontuação do teste de vida do áudio.

Outras respostas

Código	Descrição
400	Campo obrigatório ausente, áudio com formato não suportado ou amostra inválida.
401	Token ausente, inválido ou expirado.
403	O consumer não está provisionado com o serviço VOICE_AUTHENTICATION.

O corpo de uma resposta de erro tem o formato descrito em MIDAPI v2.