Repasse de upload

O repasse de upload (upload relay) é o ponto de terminação para onde o cliente envia os bytes de arquivos. Cada URL de upload possui uma capacidade assinada (capability) e o repasse armazena o objeto autorizado. Solicitar URLs de upload de anexo e Criar URL de upload de prévia de transmissão as emitem. Consulte Upload de anexos para o fluxo completo.

URL base e autorização

Caminhos aqui são relativos à base de repasse informada na URL de upload emitida.

A capacidade na query string é a autorização completa. O repasse não lê o cabeçalho Authorization da API HTTP e não possui rate limit por requisições. O método PUT exige que o processo esteja operando em modo upload ou relay.

A URL completa é autenticada

A chave no caminho e o token t na query string são vinculados criptograficamente. O cliente DEVE usar a URL exatamente como emitida, sem alterar codificações ou parâmetros.

Objeto de capacidade do repasse

O parâmetro t é um token bearer opaco. URLs de upload expiram após 900 segundos (15 minutos) por padrão. Tokens ausentes, inválidos ou expirados retornam 401 Unauthorized.

Enviar objeto de repasse (Put relay object)

PUT/v1/relay/{key}

Faz o upload do objeto ou parte autorizada pela capacidade. Retorna 200 com corpo vazio e cabeçalho ETag opcional.

Parâmetros de caminho

Campo	Tipo	Descrição
key	string	A chave do objeto da URL emitida

Parâmetros de query

Campo	Tipo	Descrição
t	string	O token opaco de upload
uploadId?	string	Identificador do upload multipart (se aplicável)
partNumber?	integer	Número da parte do upload multipart (se aplicável)

Cabeçalhos de requisição

Campo	Tipo	Descrição
Content-Length?	integer	Tamanho exato em bytes do corpo da requisição
Content-Type?	string	Tipo de mídia a ser armazenado

Respostas

Status	Corpo	Condição
200	vazio	Objeto ou parte armazenada com sucesso
400	Bad Request	partNumber inválido ou corpo interrompido antes do fim
401	Unauthorized	Capacidade ausente, malformada ou expirada
403	Forbidden	Parâmetros discordam da capacidade assinada
404	Not Found	Endpoint não opera em modo de repasse
413	Payload Too Large	Corpo excede o tamanho autorizado ou o limite do endpoint
500	Internal Server Error	Erro local ao gravar o upload
502	Bad Gateway	Erro de comunicação com o armazenamento de objetos
503	Service Unavailable	Capacidade de upload insuficiente no momento

Vincular a chave à mensagem finaliza o anexo

O envio bem-sucedido no repasse grava os bytes no armazenamento, mas não cria mensagens. Chame Criar mensagem informando o upload_filename correspondente para associá-lo.