> 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 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](/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                                                                                                        |
| ---------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| `áudio`    | string | **Sim**     | Áudio a autenticar, em Base64.                                                                                   |
| `template` | string | **Sim**     | Amostra de voz emitida no [cadastro](/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  | 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](/docs.facephi-pt-br/api-rest/midapi-v2.md#respuestas-de-error).