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

{
  "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.