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

# Detokenize Image

Servicio que devuelve la imagen abierta correspondiente a un token de mejor imagen generado por el SDK de captura.

Opera sobre el token que recibe y no sobre un asset almacenado, por lo que no admite referencia ni cabecera `operation-id`.

### Endpoint

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

### Headers

| Nombre            | Tipo   | Requerido | Descripción                                                                                               |
| ----------------- | ------ | --------- | --------------------------------------------------------------------------------------------------------- |
| **Authorization** | string | **Sí**    | Token de consumer en formato `Bearer <token>`. Ver [Autenticación](/api-rest/midapi-v2/autenticacion.md). |
| **consumer-id**   | string | **Sí**    | Identificador del consumer.                                                                               |

### Cuerpo de la solicitud

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

#### Parámetros

| Parámetro        | Tipo   | Requerido | Descripción                             |
| ---------------- | ------ | --------- | --------------------------------------- |
| `bestImageToken` | string | **Sí**    | Token de la mejor imagen de la captura. |

#### Ejemplo de solicitud

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

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

#### Otras respuestas

| Código | Descripción                                                     |
| ------ | --------------------------------------------------------------- |
| `400`  | El token es inválido o no puede destokenizarse.                 |
| `401`  | Token ausente, inválido o caducado.                             |
| `403`  | El consumer no está aprovisionado con el servicio `DETOKENIZE`. |

El cuerpo de una respuesta de error tiene la forma descrita en [Middleware API v2](/api-rest/midapi-v2.md#respuestas-de-error).