Skip to main content

POST Completar Upload Direto

Finaliza upload direto de exames da triagem.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_triages.


Endpoint​

POST https://api-dev.imagemais.com.br/api/triages/{id}/direct-upload/complete

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID da triagem

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
patientIdnumber✅inteiroID do paciente
examTypestring✅não vazioTipo do exame
filesobject[]✅ao menos 1 item; até MAX_DIRECT_UPLOAD_FILES itensArquivos enviados a registrar
files[].keystring✅não vazioKey do objeto no bucket, retornada pelo initiate
files[].fileNamestring✅não vazioNome de arquivo gerado (uuid.ext), retornado pelo initiate
files[].originalNamestring✅não vazioNome original do arquivo
files[].uploadIdstring❌—UploadId da sessão multipart (ausente em upload single)
files[].partsobject[]❌ao menos 1 itemPartes enviadas com seus ETags (somente multipart)
files[].parts[].partNumbernumber❌inteiro; mín. 1Número da parte
files[].parts[].etagstring❌não vazioETag retornado pelo PUT da parte

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/direct-upload/complete' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 1,
"examType": "Raio-X",
"files": [
{
"key": "exemplo",
"fileName": "texto",
"originalName": "texto"
}
]
}'

Respostas​

201 Sucesso​

400 Requisição inválida​

Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:

{
"message": [
"patientId must be an integer number",
"examType should not be empty",
"examType must be a string",
"files must contain no more than 10 elements",
"files must contain at least 1 elements",
"files must be an array"
],
"error": "Bad Request",
"statusCode": 400
}

Outras mensagens possíveis:

  • Key inválida para o arquivo: exame.pdf
  • Validation failed (numeric string is expected)
{
"message": "Key inválida para o arquivo: exame.pdf",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

{
"message": "Triagem não encontrada",
"error": "Not Found",
"statusCode": 404
}