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
- Chame esta rota.
- Faça o(s)
PUTpara a(s) URL(s) retornada(s) — em multipart, uma parte por URL, guardando oETagde cada resposta. - 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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da pré-consulta |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
patientId | number | ✅ | ID do paciente (compõe o caminho de armazenamento) |
examType | string | ✅ | Tipo/nome do exame (ex.: "Raio-X") |
files | array | ✅ | 1 a 10 arquivos |
files[].fileName | string | ✅ | Nome original — extensão pdf, jpg, jpeg, png, gif ou webp |
files[].fileSize | number | ✅ | Tamanho em bytes (máx. 15728640) |
files[].contentType | string | ✅ | 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
}