> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/voice-services/voice-authentication.md).

# Autenticação por voz

Serviço que compara um áudio com um modelo de voz emitido durante o 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>`. Consulte [Autenticação](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sim**     | Identificador do consumer.                                                                                                                               |

### Corpo da solicitação

**Content-Type:** `application/json`

#### Parâmetros

| Parâmetro  | Tipo   | Obrigatório | Descrição                                                                                                                                      |
| ---------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `audio`    | string | **Sim**     | Áudio a ser autenticado, em Base64.                                                                                                            |
| `template` | string | **Sim**     | Modelo de voz emitido durante o [cadastro](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2/voice-services/voice-enrollment.md). |

#### Exemplo de solicitação

```json
{
  "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  | Data e hora da resposta no formato **ISO 8601**.      |
| `message`         | string  | Campo descritivo do resultado da execução do serviço. |
| `operationResult` | inteiro | Código do resultado da execução do serviço.           |
| `match`           | boolean | Indica se o áudio corresponde ao modelo.              |
| `matchingScore`   | número  | Pontuação de correspondência.                         |
| `livenessScore`   | número  | Pontuação do teste de vida do áudio.                  |

#### Outras respostas

| Código | Descrição                                                                     |
| ------ | ----------------------------------------------------------------------------- |
| `400`  | Campo obrigatório ausente, áudio em formato não suportado ou modelo inválido. |
| `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 [Middleware API v2](https://docs.facephi.com/docs.facephi-pt-br/api-rest/midapi-v2.md#respuestas-de-error).
