Salvar asset

Serviço que armazena um asset em um contexto de uma operação e devolve a chave com a qual ele é referenciado depois.

Endpoint

POST /storage

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
operationId	string	Sim	Identificador da operação à qual o asset pertence, conforme foi devolvido Create Operation.
asset	object	Sim	Asset a armazenar.
asset.context	string	Sim	Contexto do asset. Veja Contextos de asset.
asset.file	string	Sim	Conteúdo do asset codificado em Base64, com o formato exigido pelo seu contexto.

Os quatro contextos de imagem exigem o buffer tokenizado gerado pelo SDK de captura. Uma imagem JPEG ou PNG em Base64 é rejeitada com 400. O único contexto que aceita um binário livre é TOKEN_BIN_IAD.

O tamanho máximo por asset é de 10 MiB, aplicado ao conteúdo codificado.

Exemplo de solicitação

{
  "operationId": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04",
  "asset": {
    "context": "TOKEN_FRONT_DOCUMENT",
    "file": "<base64>"
  }
}

Respostas

200 Sucesso

Parâmetros de resposta

Parâmetro	Tipo	Descrição
fileKey	string	Chave do asset, no formato {operationId}/{CONTEXTO}. É reenviada sem modificações ao referenciar o asset.
timestamp	string	Carimbo de data e hora da resposta no formato ISO 8601.

Exemplo de resposta

{
  "fileKey": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_FRONT_DOCUMENT",
  "timestamp": "2026-06-26T12:00:03.000Z"
}

Contextos derivados

Ao armazenar um asset TOKEN_BIN_IAD também fica disponível o contexto TOKEN_BEST_IMAGE da mesma operação, com a melhor imagem dessa captura. Pode ser armazenado um TOKEN_BEST_IMAGE próprio depois; se já houver um armazenado, esse é mantido.

Consulte Get File Keys para confirmar quais contextos estão disponíveis na operação.

Outras respostas

Código	Descrição
400	O operationId não tem o formato esperado, o conteúdo não corresponde ao contexto declarado, ou o asset está vazio ou excede o tamanho máximo.
403	O consumer não está provisionado com o serviço STORAGE.
404	A operação não existe ou pertence a outro consumer.
409	Já existe um asset desse contexto na operação.
410	A operação expirou.
429	O consumer ultrapassou seu limite de taxa de requisições. A resposta inclui Retry-After com os segundos de espera, e X-RateLimit-Limit e X-RateLimit-Burst com os limites vigentes.

O corpo de uma resposta de erro tem o formato descrito em MIDAPI v2.