Skip to main content

POST Iniciar Upload Direto de Exames

Gera URLs pré-assinadas para o cliente enviar os exames do paciente diretamente ao storage (Cloudflare R2). Arquivos até 10 MB recebem uma única URL (mode: "single"); maiores são enviados em partes de 10 MB (mode: "multipart").

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_preconsultations.

Fluxo completo
  1. Chame esta rota.
  2. Faça o(s) PUT para a(s) URL(s) retornada(s) — em multipart, uma parte por URL, guardando o ETag de cada resposta.
  3. Chame Completar Upload Direto.
    As URLs expiram em 600 segundos. Regras de extensão e tamanho: Configuração do Upload.

Endpoint​

POST https://api-dev.imagemais.com.br/api/pre-consultations/{id}/direct-upload/initiate

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID da pré-consulta

Corpo da Requisição​

CampoTipoObrigatórioDescrição
patientIdnumber✅ID do paciente (compõe o caminho de armazenamento)
examTypestring✅Tipo/nome do exame (ex.: "Raio-X")
filesarray✅1 a 10 arquivos
files[].fileNamestring✅Nome original — extensão pdf, jpg, jpeg, png, gif ou webp
files[].fileSizenumber✅Tamanho em bytes (máx. 15728640)
files[].contentTypestring✅Content-Type do arquivo

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/pre-consultations/29/direct-upload/initiate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 53,
"examType": "Raio-X",
"files": [
{
"fileName": "exame.pdf",
"fileSize": 1000000,
"contentType": "application/pdf"
}
]
}'

Respostas​

201 Criado​

Em mode: "multipart", cada arquivo traz também uploadId, partSize e a lista parts[] (partNumber, url) — mesmo formato de Iniciar Upload Direto das consultas.

{
"files": [
{
"mode": "single",
"originalName": "exame.pdf",
"fileName": "48a46ec8-a805-46a6-9b4a-67adb7770026.pdf",
"key": "pre-consultation/53/29/raio-x/1af6d965b2359d358bb4e38cc949a3417d13184078280bd7032a7ffba503cd5d",
"uploadUrl": "https://imagemais-bucket-development.b26dbae339f36de5139f8e8587f7cd7b.r2.cloudflarestorage.com/pre-consultation/53/29/raio-x/1af6d965b2359d358bb4e38cc949a3417d13184078280bd7032a7ffba503cd5d?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=600&..."
}
]
}

400 Arquivo inválido​

Retornado quando a extensão não é aceita ou o arquivo passa de 15 MB.

{
"message": [
"files.0.Tipo de arquivo não permitido: exame.exe"
],
"error": "Bad Request",
"statusCode": 400
}

404 Pré-consulta não encontrada​

Retornado quando o id não existe, foi excluído ou pertence a outra conta.

{
"message": "Pré-consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}