Skip to main content

POST Abortar Upload Direto

Aborta uma sessão de upload multipart pendente, descartando as partes já enviadas ao R2. Use quando o usuário cancelar o envio de um arquivo grande no meio do processo.

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 as permissões create_consultations e update_consultations. Tanto com token JWT quanto com API Key, todas são obrigatórias.

Apenas para uploads multipart

Só faz sentido para arquivos que geraram mode: "multipart" em Iniciar Upload Direto (arquivos maiores que 10 MB). Uploads single não têm sessão para abortar — basta não completá-los.


Endpoint​

POST https://api-dev.imagemais.com.br/api/consultations/direct-upload/abort

Corpo da Requisição​

CampoTipoObrigatórioDescrição
keystring✅key retornada pelo initiate (deve começar com consultation/)
uploadIdstring✅uploadId da sessão multipart, retornado pelo initiate
ID da consulta extraído da key

O servidor extrai o consultationId diretamente da key (formato consultation/{patientId}/{consultationId}/{examType}/{fileName}) para validar que a consulta existe e pertence à conta autenticada.


Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/consultations/direct-upload/abort' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"key": "consultation/9/17/raio-x/7fc828818eed96c3b3c7a94c8118a3e7b95156b5425fddc91e2a854c11631ad8",
"uploadId": "AEI2gpj0SABougXtRKFai2E2lCdp3hfiLrcjmemx5KhFwoY2wpUp..."
}'

Respostas​

201 Upload abortado​

{
"message": "Upload abortado com sucesso"
}

400 Key inválida​

Retornado quando a key não começa com consultation/ ou não contém um consultationId numérico válido na posição esperada.

{
"message": "Key inválida",
"error": "Bad Request",
"statusCode": 400
}

404 Consulta não encontrada​

Retornado quando o consultationId extraído da key não corresponde a nenhuma consulta existente na conta.

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