> 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/biometric-services/detokenize-image.md).

# Destokenizar imagem

Serviço que devolve a imagem aberta correspondente a um Token de melhor imagem gerado pelo SDK de captura.

Opera sobre o token que recebe e não sobre um asset armazenado, por isso não admite referência nem cabeçalho `operation-id`.

### Endpoint

```
POST /biometric/face/detokenize
```

### 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                          |
| ---------------- | ------ | ----------- | ---------------------------------- |
| `bestImageToken` | string | **Sim**     | Token da melhor imagem da captura. |

#### Exemplo de solicitação

```json
{
  "bestImageToken": "BAMBAQLNHJoWGPjfeuDIzDXdZuP..."
}
```

### 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.       |
| `imageBuffer`   | string | Imagem resultante, em Base64.                               |

#### Outras respostas

| Código | Descrição                                                    |
| ------ | ------------------------------------------------------------ |
| `400`  | O token é inválido ou não pode ser destokenizado.            |
| `401`  | Token ausente, inválido ou expirado.                         |
| `403`  | O consumer não está provisionado com o serviço `DETOKENIZE`. |

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).