Skip to main content

POST Iniciar Upload Direto

Inicia upload direto de exames da triagem. Gera presigned URLs para o R2 — o OCR só é enfileirado se a triagem virar consulta.

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/initiate

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 a enviar
files[].fileNamestring✅não vazioNome original do arquivo
files[].fileSizenumber✅inteiro; mín. 1; máx. MAX_DIRECT_UPLOAD_SIZETamanho do arquivo em bytes (máx 15 MB)
files[].contentTypestring✅não vazioContent-Type do arquivo

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/direct-upload/initiate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 1,
"examType": "Raio-X",
"files": [
{
"fileName": "raio-x-torax.pdf",
"fileSize": 10485760,
"contentType": "application/pdf"
}
]
}'

Respostas​

201 Sucesso​

{
"files": [
{
"mode": "single",
"originalName": "exame.pdf",
"fileName": "b6d9d69d-a19c-4014-82a0-5bd9618e4bd7.pdf",
"key": "triage/62/20/hemograma/7f8ea8ab9c37...pdf",
"uploadUrl": "https://storage.exemplo.com.br/arquivo?assinatura=..."
}
]
}

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
}

Também retornado com a mensagem:

{
"message": "Validation failed (numeric string is expected)",
"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
}